mirnoorata avatar

Codexa

mirnoorata/codexa

A read-only governance layer for AI coding agents that indexes your codebase locally and serves evidence-backed context packets through MCP. You get tools like change_plan to snapshot file hashes and symbol baselines before edits, post_edit_review to diff the dirty tree against that plan, and a verification ledger that parses reported commands against a POSIX shell subset to detect exit masking. Deep support for TypeScript, JavaScript, and Python with shallow coverage for Rust, Go, and Java. Works with any MCP host including Codex CLI and Claude Code through stdio transport. The core profile exposes six primary-loop tools to minimize schema token cost, while the full profile gives you all twenty. No model calls, no API keys, everything runs locally with deterministic output.

GitHub stars
2
tools
3
transport
STDIO
env var
1
last updated
Oct 1, 2026

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

searchFresh installs expose three tools: search, change_plan, and capabilities.

Fresh installs expose three tools: search, change_plan, and capabilities.

No parameter schema in public metadata yet.

change_planFresh installs expose three tools: search, change_plan, and capabilities.

Fresh installs expose three tools: search, change_plan, and capabilities.

No parameter schema in public metadata yet.

capabilitiesProvides access to the remaining operations; use --tools full to list every operation directly.

Provides access to the remaining operations; use --tools full to list every operation directly.

No parameter schema in public metadata yet.

Sponsors

Configuration

CODEXA_MCP_STRUCTURED_BUDGET_BYTES

Optional structured-result byte budget override for hosts with small MCP result limits.

Readme

Codexa

Check npm

Understand the code. See what a change could affect. Check the evidence.

Codexa helps developers and AI coding assistants work on a repository with more context and fewer guesses. It builds a local map of your code, connects files to their dependencies and tests, and produces readable reports about proposed and completed changes.

Think of it as a map and a change checklist for your project. The person—or coding assistant—still drives. Codexa points out the bridge you might want to check before taking the truck across it.

Use it from a terminal, with Codex, Claude Code, or another compatible coding assistant, or in GitHub Actions to help review pull requests. The core needs no API key, hosted account, or database. Codexa is free and MIT-licensed; your AI assistant and any optional hosted services have their own requirements and costs.


View the full README on GitHub

Details

Repository
github.com/mirnoorata/codexa
Package
@mirnoorata/codexa
Transport
STDIO
Registry
MCP registry, active