context-mgr

A Claude Code plugin that installs the multi-agent context manager into any project — a .context/ shared brain, a routing table, CLI bootstraps for Codex and Gemini, and an optional wrapper for non-Claude CLIs.

After install, any agent or CLI window can pick up work in the project exactly where the previous one left off, with no loss of continuity.

What this plugin does

When invoked, the context-mgr skill runs an installer that scaffolds the following into a target directory (default: the current working directory):

<target>/
├── .context/
│   ├── CHARTER.md       ← static protocol
│   ├── STATE.md         ← live board (starter)
│   ├── LOG.md           ← handoff journal (starter)
│   ├── DECISIONS.md     ← decision records (starter)
│   ├── README.md
│   └── archive/         ← rolled-off LOG entries
├── .claude/
│   └── settings.json    ← SessionStart/Stop hooks (merge if file exists)
├── agents.yaml          ← routing table — edit for your model lineup
├── AGENTS.md            ← Codex CLI bootstrap
├── GEMINI.md            ← Gemini CLI bootstrap
└── context-run.sh       ← optional wrapper for non-Claude CLIs

And appends .context/lock to the project’s .gitignore.

How to install the plugin

Install it into Claude Code from this repo:

/plugin install loudalo/context-mgr

(Adjust the owner/repo based on where this lives in your distribution.)

How to use it after install

In any project, ask Claude:

“Install context-mgr here” “Set up multi-agent context in /path/to/project” “Add the shared brain to this project”

The skill triggers, runs the installer, and reports next steps.

Idempotency and safety

The installer is safe to re-run. By default it never overwrites; it skips existing files and reports them. Flags:

• --check — dry run; report what would happen.
• --force — overwrite existing files.
• --skip-hooks — leave .claude/settings.json alone.

What’s included

This plugin bundles two skills:

• context-mgr — the installer. Invoked by name; runs install.sh and reports next steps.
• session — the runtime. Executes check-in, optional mid-session checkpoint, and check-out. Triggered by phrases like “what should I work on?”, “check in”, “checkpoint”, “check out”.

Both are project-scoped: they activate only in sessions where this plugin is installed. Non-Claude CLIs (Codex, Gemini) use the AGENTS.md, GEMINI.md, and context-run.sh files installed by context-mgr instead.

Source / development

This plugin is the distribution form of the work in the multi-agent-context/ project. The plugin bundles a snapshot of the project’s protocol files as templates. To upgrade an existing install, re-run the skill with --force (you’ll lose any local edits to the protocol files but keep your STATE / LOG / DECISIONS).

Download

The plugin is available as a zip archive you can drop into any Claude Code project’s .claude/plugins/ folder for local installation:

⬇ context-mgr.zip