FAQ

Does ctx send my code anywhere?

No. The index lives in .ctx/ inside your repository. ctx opens no network connections, sends no telemetry, and never executes project code. The MCP server runs as a child process over stdio — nothing leaves the machine.

Which languages are supported?

TypeScript/JavaScript, Python, Rust, and Go. Each is parsed with a tree-sitter grammar, and dependency resolution is language-aware.

Does it use embeddings or an LLM?

No. The graph is built with static analysis, and ranking is a deterministic scoring function. There are no API calls, no models, no keys — which is also why the results are reproducible.

How is this different from a grep or ripgrep wrapper?

grep finds lines; ctx knows structure. It knows that create_user is a function defined in one file and called from others, which files import which, and what a change would ripple into. Skeleton output gives an agent signatures and exports without bodies, and impact analysis walks real dependency edges instead of matching text.

Why a code graph instead of an embedding index?

Embeddings answer "what is this about?" — fuzzy semantic similarity. ctx answers "where does this live, what calls it, what would break?" which are exact questions with exact answers. For agents working on a codebase, exactness matters more than similarity.

Can it index a monorepo?

ctx indexes whatever directory you point it at, including the root of a monorepo. Use -R DIR to point any command at a specific project root.

Does it work with my editor / agent?

If your tool speaks MCP over stdio, it works. Claude Desktop, Cursor, opencode, VS Code (Cline, Roo), and most other MCP clients are covered in the MCP guide.

What does the index cost at runtime?

The binary is a single static-ish Rust executable with no runtime dependencies. Initial indexing of a moderate repository takes about a second; incremental re-indexing is typically tens of milliseconds.

Can I use ctx in CI?

Yes. Every command supports --json, so ctx diff and ctx impact can feed checks, code review, or changelog generation.