
Why it mattersA coding agent that reads the whole repo before every task burns tokens and misses things. A shared index the team keeps in Git is a cheaper starting point for the next agent.
AOCI-CODE passed 2,222 stars on GitHub and ranked second on Trendshift's daily list at the time of writing. The project's own description: a persistent, Git-tracked map of a whole codebase and database schema that coding agents read before they touch anything. The code is a single Go program that serves an MCP interface and a CLI.
What the index holds
Each file or database table gets a plain-text entry. The project calls the shape FRAS. F is the function of the thing. R lists other things that must be changed with it. A describes its interface or contract. S holds "important information beyond F, R, and A."
The index lives in four files at the root of the repository. The README lists aoci.txt, aoci.meta.txt, aoci.code.txt and an optional aoci.database.txt. A hidden .aoci/ folder holds state and recovery data. Everything is text, and Git tracks it alongside the code.
How an agent uses it
The MCP server exposes nine tools. The read tools are aoci_rules, aoci_overview, aoci_get_entries and aoci_search. The maintenance tools are aoci_maintain, aoci_update_entry and aoci_remove_entry. Two more, aoci_header and aoci_report, serve as evidence that the agent read the index. The README lists Claude Code, Codex, Cursor and OpenCode as supported clients.
How databases plug in
AOCI-CODE indexes a database schema alongside the code. The README names PostgreSQL, MySQL from version 5.7.6, and openGauss 6.0.5 LTS. The server reads the schema locally. It writes a line per table into aoci.database.txt. The README states nothing leaves the local machine.
How active the project is
AOCI-CODE's first stable release, v0.1.0, was tagged on 3 November 2026. The latest release at the time of writing is v0.2.0-rc2, tagged on 17 November. The v0.1.1 release before it fixed a PostgreSQL driver security issue flagged as GHSA-95fj-3fxw-g62g. The license is FSL-1.1-MIT, which the README calls "Fair Source/source-available software."
A team running Claude Code or Cursor on a mid-sized repository knows the cost. Every task starts with the agent asking what the files do, then forgetting it on the next task. A shared text index that Git tracks is a cheaper handoff than a model reading everything again. The project is new, pre-1.0, and the map falls out of date the moment code changes without maintenance. A side project is the right place to try it.
Source
This item was written by an AI system from the linked source. Reveneau is responsible for what it publishes.
Get AI News in your inbox
New developer tools, model and agent releases, and how teams are actually using them to release software. Short, and only when there is something worth reading.
