mirnoorata/codexa

Codexa

Codexa is a local codebase map for AI coding agents.

In plain English: it reads a repository, builds a compact index of the files, symbols, imports, tests, risks, and workflows it can prove, then gives Codex or another MCP client small evidence-backed packets before and after edits. It is meant to help an agent answer questions like:

• What should I read first?
• What could this change break?
• Which tests are relevant?
• Did my final dirty tree match the plan I saved before editing?

It is not an autonomous coding agent. It does not edit your source files through MCP. It is a context compiler, query server, and verification guide.

Maintainer Expectations

Codexa is maintained by one person, in spare time, with a deliberately narrow scope. That shapes how this repo works:

• Response times are days to weeks, not hours.
• Scope is narrow on purpose. Deep native language indexers, new LLM analysis layers, broad IDE products, and general-purpose search modes are usually out of scope.
• Not every working PR will be merged. Open an issue first for anything beyond a typo or small docs fix.
• Security issues go through private advisories, not public issues. See SECURITY.md.
• Questions and "is this the right tool?" discussions belong in Discussions, not the issue tracker.

Quick Start

Codexa requires Node.js 22 or newer.

Current checkout setup:

git clone https://github.com/mirnoorata/codexa.git
cd codexa
npm install
npm run build
npm link

Wire Codexa into another repository:

codexa init /path/to/project
codexa session-start /path/to/project

After codexa init, the target repository gets a repo-local .codex/config.toml entry that lets Codex discover the Codexa MCP server automatically.

The package metadata targets @mirnoorata/codexa and the installed command is codexa. If the