⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

operator-index

aerovato@aerovato⭐ 512 stars· last commit 10d ago· 1 open issues

Build or refresh the Operator Project Index.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐⭐⭐ 512 on GitHubGitHub ↗

Popular

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README


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

  • Complete Context Engine — Documentation, memory, indexes, and skills within a single integrated system.
  • Automatic Documentation — Specs, decisions, research, and more are automatically documented by the agent.
  • Transparent Memory — Memory is stored as Markdown documents you can read, update, and delete.
  • Sharable Knowledge — Track documents with Git and share knowledge with your team.
  • Zero Infrastructure — No background agents, no embeddings, no vector database, no model configuration.

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.

HarnessStatusInstall
Claude Code (CLI + Desktop)🟢 Fully Supportedoperator-helper install claude-code
Codex (CLI + Desktop)🟢 Fully Supportedoperator-helper install codex
OpenCode🟢 Fully Supported (V2)operator-helper install opencode
OpenCode V1 (legacy)🟡 Supported, Legacyoperator-helper install opencode-v1
Pi🟢 Fully Supportedoperator-helper install pi
DeepSeek Harness🟢 Fully Supportedoperator-helper install deepseek
Kiro🟡 Supportedoperator-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.

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:

  • .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 projects

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.

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:

  • "Write a spec for this feature before implementing it."
  • "Record this research so we do not repeat the investigation."
  • "These two documents overlap. Consolidate them."
  • "This document is too large. Split it."
  • "Promote this spec to Shared so the team receives it."

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

  • Observation Engine — Learn durable user observations over time, kept separate from explicit User Instructions.
  • Reliable Brain Updates — Keep specs and other Brain documents current during long conversations, instead of relying only on the agent to remember.

Context Management

  • Cache-Aware Preamble Rendering — Automatically refresh preamble when cache expires.
  • Context Management — Custom strategies for compaction, pruning, and context management.
  • Lossless Context Compression — Losslessly extend context via lossless context compression.

VS Other Memory Plugins

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

Learn More

  • Getting Started - onboarding and usage guide: how Operator works, setup, daily use, directing the agent, and reviewing the Brain. Includes the command reference.
  • Architecture - how partitions, catalogs, indexes, and deterministic context loading work.
  • Harness docs - per-harness installation, verification, commands, updates, and troubleshooting.
  • Troubleshooting - validation, repair, and update recovery.

License

BSD 3-Clause. See LICENSE.

// HOW IT'S BUILT

// FILES

3 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • packages/codex/skills/operator-index/SKILL.md928 B8371a8b5c713upstream ↗
    ---
    name: operator-index
    description: Build or refresh the Operator Project Index.
    ---
    
    # Operator Project Index Setup
    
    1. Run `operator-helper version`. If an update is available, run `operator-helper upgrade` before continuing.
    2. Run `operator-helper index init` and follow the emitted Project Index Setup guide, including when inspection reports failures.
    
    If the Project Brain is missing, tell the user to invoke `$operator-project-init` to set it up.
    
    ## Recovery
    
    - If Helper cannot start, install or repair the npm package `@aerovato/operator-helper` globally and retry the failed command.
    - If the version check or upgrade fails, diagnose the error and retry.
    - If `operator-helper index init` reports a failure, use its output to resolve it and rerun it as needed.
    - If you cannot resolve a problem, report the blocker.
    
    Use Helper output as working context. Do not reproduce it wholesale or reimplement Helper logic.
    
  • packages/codex/skills/operator-index/agents/openai.yaml104 Bce193590c616upstream ↗
    interface:
      display_name: "Operator: Refresh Project Index"
    policy:
      allow_implicit_invocation: false
    
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/aerovato-operator-memory-packages-codex-skills-operator-index.md

// REPO STATS

512 stars
1 open issues
Last commit: 10d ago