Who it is forA developer using Claude Code or Codex on a large repository who wants the assistant to find relevant code with less searching and smaller context.
The problemAssistants that search broadly consume large context and can miss the implementation path for a question.
The outcomeAn assistant that starts from the bounded Agent Orientation and runs focused queries that return graph-backed locations.
What you need first
- A terminal on macOS, Linux, or Windows
- A local project folder or Git repository to analyze
- Rust 1.97.1 or newer only if you build from source
Steps
cd your-projectcompass initcompass install --platform codexorcompass install --platform claude(inferred, check the README)compass watchin a second terminal to keep the graph current while you work.compass query "where is authentication enforced?"to test a focused question before giving it to the assistant.
Prompt for your agent
In the repository at <project path>, confirm that compass-out/ exists, then run `compass query "<your question>"` with the crabbuild/compass CLI. Expected output: a concise map of seed nodes, edges, and source locations for the question. Verify that the returned source locations exist in the repository before you edit any file.
Caveat. Keep `compass watch` running while the assistant works, or the graph can lag behind your latest edits.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for crabbuild/compass and "Give Claude Code or Codex focused repo context"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer