AOCI-CODE
Local-first MCP server and Go CLI that maintains a persistent Git-versioned index of codebase and database schema for coding agents.
Tested on LinuxKnown vulnerabilities
Use it
Before you install: known vulnerabilities
pickfit found 14 known high or critical vulnerabilities in the packages a fresh install brings (OSV.dev, 3 Nov 2026). Weigh this before you install it.
go:golang.org/x/crypto v0.0.0-20210711020723-a769d52b0f97golang.org/x/crypto vulnerable to auth bypass via unenforced @revoked status (GHSA-5cgq-3rg8-m6cv, critical, fixed in 0.52.0)
See 9 more
go:golang.org/x/crypto v0.0.0-20210711020723-a769d52b0f97— GHSA-89gr-r52h-f8rx (critical), fixed in 0.52.0go:golang.org/x/crypto v0.0.0-20210711020723-a769d52b0f97— GHSA-f5wc-c3c7-36mc (critical), fixed in 0.52.0go:golang.org/x/crypto v0.0.0-20210711020723-a769d52b0f97— GHSA-jppx-rxg9-jmrx (critical), fixed in 0.52.0go:golang.org/x/crypto v0.0.0-20210711020723-a769d52b0f97— GHSA-rm3j-f69w-wqmq (critical), fixed in 0.52.0go:golang.org/x/crypto v0.0.0-20210711020723-a769d52b0f97— GHSA-v778-237x-gjrc (critical), fixed in 0.31.0go:golang.org/x/crypto v0.0.0-20210711020723-a769d52b0f97— GHSA-vgwf-h737-ff37 (critical), fixed in 0.52.0go:golang.org/x/crypto v0.0.0-20210711020723-a769d52b0f97— GHSA-x527-x647-q7gg (critical), fixed in 0.52.0go:golang.org/x/crypto v0.0.0-20210711020723-a769d52b0f97— GHSA-8c26-wmh5-6g9v (high), fixed in 0.0.0-20220314234659-1baeb1ce4c0bgo:golang.org/x/crypto v0.0.0-20210711020723-a769d52b0f97— GHSA-gwc9-m7rh-j2ww (high), fixed in 0.0.0-20211202192323-5770296d904e
4 more findings not listed here.
Linux x86_64
You need first
- Runtimes:
go - System packages:
make
These steps ran from a folder named work in the home folder, which already existed. Make it and run them from there:
mkdir -p "$HOME/work" && cd "$HOME/work"download Go 1.23.6 tarball
curl -fsSL https://go.dev/dl/go1.23.6.linux-amd64.tar.gz -o /tmp/go.tar.gzextract Go to ~/.local/go and link to ~/.local/bin
mkdir -p $HOME/.local/go && tar -xzf /tmp/go.tar.gz -C $HOME/.local/go --strip-components=1 && mkdir -p $HOME/.local/bin && ln -sf $HOME/.local/go/bin/go $HOME/.local/bin/gogit clone aoci-code
git clone https://github.com/aoci-spec/aoci-code.gitmkdir -p build && CGO_ENABLED=0 go build -o build/aoci ./cmd/aoci
cd aoci-code && mkdir -p build && CGO_ENABLED=0 go build -o build/aoci ./cmd/aoci && ./build/aoci --version
Verified in pickfit: the commands exactly as its sandbox ran them
For the record only: they name the sandbox's home, /home/sbx.
curl -fsSL https://go.dev/dl/go1.23.6.linux-amd64.tar.gz -o /tmp/go.tar.gzmkdir -p $HOME/.local/go && tar -xzf /tmp/go.tar.gz -C $HOME/.local/go --strip-components=1 && mkdir -p $HOME/.local/bin && ln -sf $HOME/.local/go/bin/go $HOME/.local/bin/gogit clone https://github.com/aoci-spec/aoci-code.gitcd aoci-code && mkdir -p build && CGO_ENABLED=0 go build -o build/aoci ./cmd/aoci && ./build/aoci --versioncd aoci-code && mkdir -p build && CGO_ENABLED=0 go build -o build/aoci ./cmd/aoci && ./build/aoci --versionmkdir -p /tmp/testrepo && cd /tmp/testrepo && git init -q && git config user.email "a@a.com" && git config user.name "a" && echo "hello" > README.md && git add . && git commit -qm init && AOCI=/home/sbx/work/aoci-code/build/aoci
# F1: init + scan delivers codebase context
$AOCI --repo /tmp/testrepoCheck that it works
cd aoci-code && mkdir -p build && CGO_ENABLED=0 go build -o build/aoci ./cmd/aoci && ./build/aoci --versionThe output should contain “aoci version dev”.
First thing to try
mkdir -p /tmp/testrepo && cd /tmp/testrepo && git init -q && git config user.email "a@a.com" && git config user.name "a" && echo "hello" > README.md && git add . && git commit -qm init && AOCI="$HOME"/work/aoci-code/build/aoci
# F1: init + scan delivers codebase context
$AOCI --repo /tmp/testrepoWhat it does
- Detects code changes and guides agents to update affected index entriesTested
- Delivers whole codebase and database schema context to agents before they actNot shown working
- Supports MySQL and PostgreSQL table-level indexing alongside codeNot tested
How far pickfit got
Linux x86_64
- Installs
- Starts
- 1 of 3 features work
- Works offline
macOS and Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- provide long-term codebase context to coding agents without re-reading repository each task
- index codebase and database schema into Git-versioned map
- maintain index automatically after verified code changes
An alternative to CodeGraph, RAG and LSP.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 2 Nov 2026
- Version dev
Differences the test machine hit
- README: prerequisites: go, make - make build
In the test: make not present in box; built directly with CGO_ENABLED=0 go build -o build/aoci ./cmd/aoci - README: ./build/aoci --version shows 0.1.0-rc23
In the test: source build without LDFLAGS reports dev (commit none, built unknown)