aoci-code

A persistent, Git-versioned map of your whole codebase and database schema that coding agents read before they touch anything. Local-first MCP server + CLI in G

What is aoci-code?

A persistent, Git-versioned map of your whole codebase and database schema that coding agents read before they touch anything. Local-first MCP server + CLI in Go: a governed repository index of code knowledge that gives Claude Code, Codex, Cursor, and opencode long-term context, memory, and code intelligence.

Overview of aoci-code

What it is

A persistent, Git-versioned map of your entire codebase and database schema that coding agents read before they touch anything. It is a local-first MCP server and CLI written in Go. Agents read the index once and know the system, instead of re-reading the repo on every task. The index lives in the repository next to the code and is versioned by Git.

Key features

  • Agents start every task already knowing the whole system: what each file is for, what it depends on, and what must not break.
  • Supports taking over an existing codebase of up to about 500,000 lines in one step.
  • The index is versioned by Git, so changing people, agents, or conversations does not require starting over.
  • After the first index, maintenance is automatic: the MCP server detects changes and writes updated entries.
  • Supports indexing databases (MySQL 5.7.6+, PostgreSQL, openGauss 6.0.5 with constraints).
  • Local only: read-only on your system, no Internet, no stored credentials. It never reaches the Internet and uploads nothing.
  • The index format uses fields F (file purpose), R (relationships), A (architecture), S (sensitive constraints) to describe each file or table in one line.

Use cases

  • Building large systems without losing context.
  • Non-professional developers iterating on their own systems.
  • Professional developers handing the whole system to an agent and focusing on architecture and design.
  • Taking over an existing system in one step.
  • Changing people, agents, or conversations without starting over.

Getting started

Give your agent the following instruction to download AOCI-CODE and wire it up. After you restart the agent, send the second instruction to build the index.textAOCI-CODE project: https://github.com/aoci-spec/aoci-codeDownload the latest release package for this operating system and CPU architecture fromhttps://github.com/aoci-spec/aoci-code/releases, and follow the installation instructionson the Release page to verify it. If no compatible release package exists, or if Iexplicitly request the latest source, build it from the official repository.After extracting the package, place aoci (aoci.exe on Windows) at a stable absolute path.Then use that absolute path to do the following for my project:1. Run init to initialize AOCI and integrate MCP for the current host; if this host does not write project configuration (Cursor, for example), give me the configuration I need to paste myself2. Run scan scan takes its file inventory from Git, so do not add the cognition assets init writes (aoci.txt, aoci.meta.txt, aoci.code.txt, AGENTS.md) to .gitignore or .git/info/exclude — an ignored asset is silently skipped and the index cannot be built. Leave the host-config ignore init writes for itself as it is.3. Tell me to restart the agent so the newly written MCP server takes effectStop after those three steps and do not build the index yet — I will tell you to continueafter the restart.After restarting the agent, send this one:textFirst confirm the AOCI MCP server is connected, then build the AOCI index for this project. When it is complete, give me the AOCI panel link.

License and pricing

License is not stated (NOASSERTION). Open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/aoci-specaoci-code.svg)](https://yunodb.com/tools/aoci-specaoci-code?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/aoci-specaoci-code?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/aoci-specaoci-code.svg" alt="Featured on YunoDB" height="20"></a>