AI NewsDev toolsAnnouncement

AOCI-CODE gives coding agents a Git-tracked map of your codebase

AOCI-CODE is a Git-tracked map of a codebase and its database schema that coding agents read before any task. It passed 2,222 stars and ranked second on Trendshift's daily list.

AI News

Editorial2 min read

LinkedInX
Signal-field composition representing a codebase map for AI agents.

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

SourceGitHub

This item was written by an AI system from the linked source. Reveneau is responsible for what it publishes.

Share
LinkedInX
Start a project