Repomemo

RepoMemo

**Languages:** **English** · [简体中文](./README.zh.md)

**One project. Any coding agent. No switching ceremony.**

RepoMemo is a minimal, Git-neutral continuity layer for agent-native project directories. It bootstraps one portable file contract; after that, switch between coding Harnesses directly without running convert, sync, generate, export, or handoff commands.

Quick start

cd my-project
npx repomemo@latest init

# Switch directly after the one-time bootstrap
codex
claude
gemini
opencode

`npx @latest` may need the network to obtain RepoMemo. Once the CLI is locally available, `init` and `doctor` make no network calls.

The contract

my-project/
├── AGENTS.md              # permanent governance; canonical rules
├── AGENT_STATE.md         # advisory current-task and handoff data
├── .agents/
│   └── skills/            # canonical Agent Skills
├── CLAUDE.md              # thin @AGENTS.md bridge
├── GEMINI.md              # thin @AGENTS.md bridge
├── .claude/skills         # link to .agents/skills when available
└── .zcode/skills          # link to .agents/skills when available

The three planes are intentionally separate:

• Governance: AGENTS.md and .agents/skills.
• Continuity: AGENT_STATE.md.
• Compatibility: tiny imports and in-project links only where required.

RepoMemo manages only explicit HTML-comment blocks. User-authored text outside those blocks is preserved. Ambiguous, duplicate, or malformed markers fail closed instead of being guessed or overwritten.

Commands

repomemo init [--target DIR] [--dry-run]
repomemo doctor [--target DIR] [--harness ID] [--json]
repomemo doctor --repair [--target DIR] [--harness ID] [--json]

• init uses exactly the supplied directory or current directory. It never searches for a Git root and requires the target directory to exist.
• doctor is read-only by default. It checks the contract, state schema, bridges, links, nested/ancestor instr