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/peek)<a href="https://agentmods.dev/commands/helweg/open-codebase-index/peek"><img src="https://agentmods.dev/badge/commands/helweg/open-codebase-index/peek/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/peek"><img src="https://agentmods.dev/badge/commands/helweg/open-codebase-index/peek.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.00372 |
| Opus 5.5 | $0.00004 | $0.00149 |
| Sonnet 5.5 | $0.00002 | $0.00074 |
| Haiku 4.5 | $0.00001 | $0.00037 |
Grade A, and why
peek 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
Search the codebase using codebase_peek.
User input: $ARGUMENTS
The first part is the search query. Look for optional parameters:
limit=Nor "top N" or "first N" → set limittype=Xor mentions "functions"/"classes"/"methods" → set chunkTypedir=Xor "in folder X" → set directory filter- File extensions like ".ts", "typescript", ".py" → set fileType
author=XorblameAuthor=X→ set blameAuthor filtersha=XorblameSha=X→ set blameSha filtersince=YYYY-MM-DDorblameSince=YYYY-MM-DD→ set blameSince filteruntil=YYYY-MM-DDorblameUntil=YYYY-MM-DD→ set blameUntil filter
Call codebase_peek with the parsed arguments.
Examples:
/peek authentication logic→ query="authentication logic"/peek error handling limit=5→ query="error handling", limit=5/peek validation functions→ query="validation", chunkType="function"/peek auth logic [email protected] since=2025-01-01 until=2025-01-31→ query="auth logic", blameAuthor="[email protected]", blameSince="2025-01-01", blameUntil="2025-01-31"
If the index doesn't exist, run index_codebase first.
Return results as concise locations with file paths and line numbers. Suggest reading the returned files or using codebase_search when the user needs full code context.
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 · 30 lines · 10 tokens per session scan A 319844bf4110
peek is a command published in the GitHub repository Helweg/open-codebase-index (224 stars, last pushed yesterday), licensed MIT. It adds 10 tokens to every session and 372 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.