Ctxo

[](https://www.npmjs.com/package/@ctxo/cli) [](https://github.com/alperhankendi/Ctxo/actions/workflows/ci.yml) [](https://github.com/alperhankendi/Ctxo/actions/workflows/release.yml)

npm install -g @ctxo/cli   # one-time global install (gives you the `ctxo` command)
ctxo init
ctxo index

Detects your languages, installs the right plugins, wires Ctxo into your AI client, installs git hooks, and builds the first index one command.

---

The Problem: agents code blind

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 Solution: proactive, not reactive

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.

Codebase Dashboard

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.

Open Dashboard

Dependency Graph

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.

Open Dependency Graph

Safe-Edit Guard

AI agents don't fail because they can't code. They fail because they code blind. Ctxo gives them the full picture before they write a single line.

The problem: an agent opens a file, makes a targeted edit, and walks away. It never checked what else depends on that symbol. Downstream callers silently break. Tests pass because the agent only ran the ones in the same file.

The safe-edit guard closes this loop deterministically. When you run ctxo init, it:

1. Registers a PreToolUse hook in .claude/settings.json (Claude Code) that intercepts every Edit call.
2. Installs three model-invoked skills (ctxo-understand, ctxo-safe-edit, ctxo-review-pr) so the agent knows when to check blast radius, history, and PR risk.

If an agent tries to edit a high-impact symbol without first calling get_blast_radius, the hook blocks the edit and tells the agent what to check. Once the agent runs the tool, the edit goes through normally. Fires once per symbol per session, fail-open on any uncertainty.

Tune it:

# Preview which symbols the guard would flag at current sensitivity
ctxo gate --preview

# Check blast radius for a specific symbol (pipe to jq, CI scripts, etc.)
ctxo blast-radius "src/core/graph.ts::buildGraph::function" --json

Configure sensitivity in .ctxo/config.yaml:

gate:
  enabled: true
  sensitivity: balanced   # strict | balanced (DEFAULT) | lenient

Platform matrix:

| Platform | Hook enforcement | Skills | Rules | |---|---|---|---| | Claude Code | yes (PreToolUse blocks) | yes | yes | | Cursor | no (no blocking pre-edit hook) | yes | yes | | Other | no | where supported | yes |

Supported Languages

| Language | Plugin | Tier | Notes | |---|---|---|---| | TypeScript / JavaScript | @ctxo/lang-typescript | full | ts-morph; type-aware cross-file resolution | | Go | @ctxo/lang-go | syntax | tree-sitter; exported-symbol analysis | | C# | @ctxo/lang-csharp | full | Roslyn; .NET SDK 8+ for full tier, tree-sitter fallback | | Java | @ctxo/lang-java | syntax / full | tree-sitter syntax tier built-in; full tier via @ctxo/lang-java-analyzer companion (requires JRE 17+) |

Install via the CLI shortcut:

ctxo install typescript go csharp   # syntax or full tier auto-detected
ctxo install java                   # installs syntax tier; adds full-tier analyzer when JRE 17+ detected
ctxo install java --full-tier       # force full-tier analyzer install
ctxo install java --syntax-only     # skip analyzer, syntax tier only

Links

• Docs quick start, MCP tools, CLI reference, integrations
• npm
• [Changelog](CHANGELOG.md)
• [LLM Reference](llms-full.txt)

License

MIT

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: alperhankendi
• Source: alperhankendi/Ctxo
• License: MIT
• Homepage: https://alperhankendi.github.io/Ctxo/

Install and usage instructions live in the source repository linked above.