How aoci-spec/aoci-code works
AOCI-CODE is a local-first CLI and MCP service for building and maintaining a Git-versioned code-and-database cognition index for coding agents. The main workflow initializes host integration, scans the repository, then lets an agent use MCP tools to read, author, validate, and apply index updates; the maintained index is reused across tasks and sessions. Database metadata indexing and the read-only status panel are separate capabilities. Some subsystem wiring is based on README documentation and tree paths because their source was not sampled.
Main entry points: root.go CLI commands · entries_worker.go Entry authoring · tools_write.go MCP tools · database.go Database commands
Components 21
CLI and setup
- aoci command
cmd/aoci/main.go - CLI commands
internal/cli/root.go - Initialize host
internal/cli/init.go
Index workflow
- Repository scan
internal/cli/scan.go - Index model
internal/index/types.go - Entry authoring
internal/workflow/entries_worker.go - Prompt assembly
internal/prompt/entry.go - Project index
Agent interface
- MCP server
internal/mcptools/server.go - MCP tools
internal/mcptools/tools_write.go - Index cognition
internal/cognition/loader.go - Search and query
internal/index/query.go
Database cognition
- Database commands
internal/cli/database.go - Schema collector
internal/dbevidence/collector.go - Schema evidence
internal/dbevidence/store.go - Database index
internal/dbcognition/state.go
Status panel
- Panel commands
internal/cli/ui.go - Read-only panel
internal/ui/server.go
Other components
- User or agent
- Model endpoint
- Database engines
Connections 23
- User or agent → aoci command: runs
- aoci command → CLI commands: executes
- CLI commands → Initialize host: dispatches
- CLI commands → Repository scan: dispatches
- CLI commands → Database commands: dispatches
- CLI commands → Panel commands: dispatches
- Repository scan → Index model: builds inventory
- Index model → Project index: persists index
- User or agent → MCP server: connects agent
- MCP server → MCP tools: dispatches tools
- MCP tools → Index cognition: loads index
- Index cognition → Project index: reads index
- MCP tools → Search and query: queries entries
- Entry authoring → Prompt assembly: prepares input
- Prompt assembly → Entry authoring: returns prompt
- Entry authoring → Model endpoint: requests completion
- Entry authoring → Project index: writes drafts
- Database commands → Schema collector: collects metadata
- Schema collector → Database engines: queries catalogs
- Schema collector → Schema evidence: stores snapshots
- Database commands → Database index: builds database index
- Panel commands → Read-only panel: starts panel
- Read-only panel → Project index: reads index