Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
git clone --depth 1 https://github.com/Helweg/open-codebase-indexWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/commands/helweg/open-codebase-index/definition)<a href="https://agentmods.dev/commands/helweg/open-codebase-index/definition"><img src="https://agentmods.dev/badge/commands/helweg/open-codebase-index/definition/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/commands/helweg/open-codebase-index/definition"><img src="https://agentmods.dev/badge/commands/helweg/open-codebase-index/definition.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00010 | $0.00189 |
| Opus 5.5 | $0.00004 | $0.00076 |
| Sonnet 5.5 | $0.00002 | $0.00038 |
| Haiku 4.5 | $0.00001 | $0.00019 |
Grade A, and why
definition scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
Find the authoritative definition of a symbol in the codebase.
User input: $ARGUMENTS
The input is a symbol name or description of what to find the definition of.
Look for optional parameters:
limit=Nor "top N" → set limitdir=Xor "in folder X" → set directory filter- File extensions like ".ts", ".py" → set fileType
Call implementation_lookup with the parsed arguments.
Examples:
/definition validateToken→ query="validateToken"/definition payment handler→ query="payment handler"/definition createSystem dir=packages/react→ query="createSystem", directory="packages/react"
This prioritizes real implementation files over tests, docs, and examples.
If no definition is found, suggest using codebase_search for broader discovery.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 25 lines · 10 tokens per session scan A dcae4419f23d
definition is a command published in the GitHub repository Helweg/open-codebase-index (223 stars, last pushed yesterday), licensed MIT. It adds 10 tokens to every session and 189 once invoked, about $0.0000 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other commands, from other repositories
codesage-reset
Fully regenerate a project's CodeSage index under its writer lock, with a separate offline recovery procedure for an unreadable database.
codesage-reindex
Refresh a project's index incrementally and report retained totals separately from work performed. Clean orphan model tables after successful indexing.
search
Semantic code search via cix — find code by meaning, not by exact strings.
def
Find symbol definition(s) via cix — go-to-definition across the indexed codebase.
refs
Find symbol references via cix — locate every usage of a symbol across the codebase.
rtfm.ocr
Enable persistent OCR fallback for scanned PDFs and run the OCR pass in the background.