Home - Terrio-cz/CodeLoupe GitHub Wiki
CodeLoupe is an on-demand code index for AI coding agents. Ask for a declaration, a file outline, its usages, callers or
type hierarchy, or what a branch changed, and get exactly that piece of code instead of grepping and reading whole files.
It works on any git repository (Kotlin and Java), needs no IDE and no configuration, and serves every agent window of a
machine from one small daemon over MCP and a CLI.
New here? Start with Getting started, then Claude Code integration. The
short version, a landing page and the download, is the
README.
Use it
| Page |
What is in it |
| Getting started |
requirements, install, the first queries |
| Claude Code integration |
the plugin, the MCP entry, the desktop app's buttons |
| Tools reference |
every tool and what it returns, editing by declaration |
| Configuration |
home, port, config.json, per-repository .codeloupe.json |
| FAQ and troubleshooting |
limitations, short answers, what to try when something fails |
Features
| Page |
What is in it |
| Jobs and events |
long commands in the daemon, slots, policy, events and webhooks |
| Workspaces and Docker cleanup |
worktrees with their state, labelled Docker resources, the reconciler, build daemons, ports |
| Trackers |
the YouTrack mirror and the tools on top of it |
| Environment and secrets |
the encrypted store, env run, import, audit |
| Hooks and token savings |
the session hook, doc and the layers that keep the context small |
| Plugin hooks |
the PreToolUse hook that points searches and whole-file reads at CodeLoupe, its modes and measurements |
| Metrics and savings |
where an agent's cost goes, measured from transcripts |
| Knowledge store |
facts agents learned, with scope and code anchors that flag them stale, searched by relevance |
| Desktop app |
the tray app and its screens, accounts |
How it works
| Page |
What is in it |
| Daemon and index |
one daemon per machine, what the index holds, memory and latency |
| Worktrees and overlays |
one base index, an overlay per worktree, no watchers |
| Benchmarks |
answer size against grep, whole-file reads and GitNexus, cost of having the tool |
| Agent runs |
short read: what an agent run costs, what made it cheaper and what did not, with takeaways for your own agent flow |
| Agent run details |
every controlled experiment on real agents, with tables, method and limits |
| Comparison |
against GitNexus and an IDE's MCP server |
Install and contribute
CodeLoupe is source-available under the
PolyForm Noncommercial License 1.0.0.