The project's README from github.com/aerovato/operator-memory. As one markdown file: README.md.
Operator Memory gives your agent a brain for documenting all their work. As the agent works, it automatically documents within this brain — specs, decisions, standards, research, lessons. Every new session starts knowing everything the last one learned.
Operator is managed via the Operator Helper, which also provides setup and agent instructions. Install the Helper with npm:
npm install --global @aerovato/operator-helper
Or Bun:
bun add --global --minimum-release-age 0 @aerovato/operator-helper@latest
Then install the Operator adapter for your harness. Click each link for harness-specific information.
| Harness | Status | Install |
|---|---|---|
| Claude Code (CLI + Desktop) | 🟢 Fully Supported | operator-helper install claude-code |
| Codex (CLI + Desktop) | 🟢 Fully Supported | operator-helper install codex |
| OpenCode V2 | 🟢 Fully Supported | operator-helper install opencode-v2 |
| OpenCode V1 | 🟡 Supported, Legacy | operator-helper install opencode |
| Pi | 🟢 Fully Supported | operator-helper install pi |
| DeepSeek Harness | 🟢 Fully Supported | operator-helper install deepseek |
| Kiro | 🟡 Supported | operator-helper install kiro |
Setup is a conversation with your agent. Run each command in a new conversation.
/operator:user-init — set up your global user partition./operator:project-init — scaffold Operator, migrate existing documents, and index the repo.When starting cold on an existing project, expect a sparse brain at first; ask the agent to write the first specifications for the modules you work on. Once those documents exist, later sessions maintain them as part of ordinary work.
New to Operator? Read the Getting Started guide.
Agents excel in a single session but forget everything the moment it ends. Future sessions waste tokens re-gathering an incomplete context: re-exploring the codebase, re-learning the architecture, re-teaching decisions and corrections.
Operator gives the agent a durable workspace of Markdown, kept in three places:
.operator/ — private project knowledge, stays on your machine.operator-shared/ — project knowledge published with the repository~/.operator/user/ — your personal rules and knowledge, used across projectsEvery session runs the same loop:
When project truth changes, the agent updates the canonical file instead of adding a RAG database record. For more details, see Architecture.
Sometimes agents hesitate to create, consolidate, or split documents. In that case, steer the agent towards making larger architectural decisions:
Operator Memory is under active development. More features are on the way. Each will come with an explicit on/off switch in case you prefer the vanilla Operator experience.
Snippet capture, RAG retrieval, and context compression all fail the same way.
BSD 3-Clause. See LICENSE.