npx @ctxo/init
npx @ctxo/cli index
Detects your languages, installs the right plugins, wires Ctxo into your AI client, installs git hooks, and builds the first index one command.
Drop a modern coding agent into a real repo. It ripgreps a symbol, gets 47 hits, reads five files to find the definition, five more for callers misses the subclass entirely (inheritance doesn't show up in text search), never checks git history (and confidently reintroduces a bug that was reverted three weeks ago), then runs out of context and starts hallucinating.
It's not a skill gap. It's a sensory gap. The agent is navigating your codebase with its eyes closed and a phone book.
The core shift: your agent stops reacting to files it stumbles into and starts planning from a complete map. Blast radius before the edit. Git intent before the bug fix. Importer list before the rename.
Ctxo indexes your repo once kept fresh by file watchers and git hooks into a deterministic graph: every symbol, every edge (imports, calls, extends, implements), every relevant git commit with intent classified, every anti-pattern. All exposed through 14 semantic MCP tools.
One get_blast_radius call replaces an entire ripgrep/read spiral. One get_pr_impact replaces a full review session of "wait, what calls this?"
The agent still writes the code. It just stops writing it blind so the bug never has to be caught by the compiler, the tests, CI, or a user.
Full-stack analytics UI with eight views: File Tree, Heatmap, Co-Changes, Timeline, Architecture, MCP Explorer, and Diff. Deployed to GitHub Pages on every push.
ctxo visualize generates a self-contained HTML from your .ctxo/ index. Interactive force-directed graph with PageRank sizing, layer coloring, blast radius on click, and dark/light theme.
- Docs quick start, MCP tools, CLI reference, integrations
- npm
- Changelog
- LLM Reference
MIT