Manga Projects

Your project remembers.

Manga gives coding agents persistent project context that lives with your repository. Start in one agent, continue in another — the same .manga/ memory follows the project.

Quick start

npx manga-projects init

Then work normally:

claude

Switch later:

codex

The same .manga/ memory follows the project. No account, no AI API key, no manual "remember"/"save" commands — your coding agent maintains the memory automatically, guided by the Manga protocol.

Commands

manga init                 # set up Manga in this repository (interactive)
manga status               # memory + integration status
manga context              # deterministic memory overview (no AI)
manga mode full|read-only|off
manga connect claude|codex
manga disconnect claude|codex
manga doctor               # check for problems (never modifies)
manga repair               # fix structural issues (preview first)

Automation-friendly:

manga init --agents claude,codex --mode full --git commit --yes

Project root detection

Manga finds the project root for you. Run it from anywhere inside your project:

cd my-project/src/components
npx manga-projects init

Manga walks upward from the current directory and initializes at the project root — my-project/, where .manga/ and the agent instruction files belong.

It looks for, in order:

1. An existing .manga/ directory (an already-initialized Manga project).
2. A .git directory or file — the repository root. In a monorepo this means the repository, not the nested package.
3. A project manifest: package.json, pyproject.toml, Cargo.toml, go.mod, composer.json, Gemfile, pom.xml, build.gradle, and similar.

Manga refuses to initialize your home directory, even if it contains a .git directory or a package.json. If Manga cannot confidently identify a project root it refuses and changes nothing, rather than putting your project memory in the wrong place. There is no flag to override this.

✗ Refusing to initialize your home directory.

Manga is project memory — it belongs inside a project.

cd into your project and run:  npx manga-projects init

Nothing was changed.

Every file Manga writes is verified to be inside the resolved project root before anything touches disk.

What Manga does & doesn't do

• Creates a .manga/ folder of plain-Markdown project memory.
• Adds a small, clearly-marked managed block to your agents' config files (CLAUDE.md, AGENTS.md) — everything outside the markers is preserved.
• Does not request AI API keys, access your provider accounts, or upload your repository or memory anywhere.

Supported agents

• Claude Code (CLAUDE.md)
• Codex, Cursor, Antigravity CLI (the shared AGENTS.md standard)

Manga is a single CLI tool — no desktop app, no server, no account.

Claude, Codex, Cursor and Antigravity are trademarks of their respective owners. Manga Projects is not affiliated with or endorsed by those companies.