operator-memory README

The project's README from github.com/aerovato/operator-memory. As one markdown file: README.md.

Operator Memory, the self-improving context engine for coding agents

English | 简体中文


Operator Memory: The self-improving context engine for coding agents.

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.

Features

Installation

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.

  1. First time only: /operator:user-init — set up your global user partition.
  2. In each new project: /operator:project-init — scaffold Operator, migrate existing documents, and index the repo.
  3. Start a new conversation and do normal work.

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.

How Operator Works

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:

Every session runs the same loop:

  1. Consult — the agent starts from your Brain: instructions, codebase index, specs, guides.
  2. Build — the agent does normal development work, informed by that knowledge.
  3. Update — the agent records what changed: new specs, decisions, standards, lessons.

When project truth changes, the agent updates the canonical file instead of adding a RAG database record. For more details, see Architecture.

The memory-aware agentic loop: consult the brain, build, update the brain

Everyday Workflow

  1. Give the agent normal development work.
  2. The agent automatically consults existing knowledge: index for navigating code, specs for module contracts, guides for third-party integration details.
  3. The agent automatically updates existing knowledge: When project truth changes, the relevant documents are automatically updated.
  4. The next session continues from the updated knowledge.

Sometimes agents hesitate to create, consolidate, or split documents. In that case, steer the agent towards making larger architectural decisions:

Roadmap

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.

Brain Improvements

Context Management

VS Other Memory Plugins

Snippet capture, RAG retrieval, and context compression all fail the same way.

Learn More

License

BSD 3-Clause. See LICENSE.

operator-memory (aerovato/operator-memory)

Searching Database…

Что это?Operator Memory — самообучающийся движок контекста, дающий кодинг-агентам постоянную память: пока агент работает, он автоматически записывает спецификации, решения, исследования и уроки в Markdown, так что следующая сессия стартует, уже зная, что выучила предыдущая.
Это библиотека для импорта или плагин для моего кодинг-агента?Это система плагинов, управляемая через CLI: вы устанавливаете 'Operator Helper' через npm или Bun, затем ставите адаптер под конкретный харнесс (Claude Code, Codex, OpenCode, Pi, DeepSeek Harness или Kiro).
Как его запустить?Установите Operator Helper через npm или Bun, выполните его команду установки для вашего харнесса (например, operator-helper install claude-code), затем один раз запустите /operator:user-init и /operator:project-init в каждом проекте, чтобы создать структуру и проиндексировать Brain.
С какими кодинг-агентами он работает?Полностью поддерживаются Claude Code, Codex, OpenCode V2 (V1 всё ещё поддерживается как legacy), Pi и DeepSeek Harness; также поддерживается Kiro.
Нужна ли ему векторная база данных или фоновые агенты?Нет. Operator спроектирован без какой-либо дополнительной инфраструктуры: не нужны ни фоновые агенты, ни эмбеддинги, ни векторная база, ни настройка модели.
Где на самом деле хранится память?Приватные знания проекта лежат в локальной папке .operator/, командные знания — в .operator-shared/ (коммитятся в репозиторий), а личные правила, используемые во всех проектах, — в ~/.operator/user/.
Почему он редактирует существующие документы, а не просто дописывает новые фрагменты памяти?Когда 'истина проекта' меняется, агент прямо обновляет канонический файл спецификации или решения, удерживая Brain единым актуальным источником вместо накопления устаревших фрагментов, как это было бы с RAG-базой.
Могу ли я сам читать или редактировать память агента?Да, всё это обычный Markdown, который можно открыть, отредактировать или удалить, и можно вести его в Git, чтобы делиться знаниями с командой.
Что дальше запланировано для Operator?В роадмапе — Observation Engine для стойких пользовательских предпочтений, более надёжные обновления Brain посреди разговора, рендеринг преамбулы с учётом кэша и сжатие контекста без потерь — у каждого пункта есть переключатель вкл/выкл.
Creator
aerovato
Size
2 MB
Stars
461
Age
2mo
Commits · 90 Days