scout
Corpus orientation for agents
100% recall · 0 poison survivors · ~$0.10/query
crates.io · scout-cli 0.1.0 (binary: scout)
source on GitHubAn agent dropped into an unfamiliar directory burns 50–200K frontier tokens just orienting itself. scout does the orientation instead: it walks a corpus of code or documents, indexes it with a fast open-weight model, and answers “what’s here” and “what does it say about X” in seconds for cents. The extraction model never gets to assert an unverified claim — if a fact can’t be matched to a real quote in a real file, it doesn’t ship as a finding.
01 · hydrate
Walk the corpus
Skips harness litter and secrets, then builds a two-tier card per file: a machine-verified skeleton — symbols via ctags, import edges, git churn, heading outlines — plus a model summary labeled a hint, never a fact. Cards are hash-keyed; only changed files cost money on the next run.
02 · route
Ask a question
A query routes against the index to a candidate file set, then a fast open-weight model (Cerebras gemma-4-31b) extracts candidate facts per chunk — the orientation an agent would otherwise burn 50–200K frontier tokens gathering by hand.
03 · verify
Quote firewall
Every finding must carry a verbatim quote that machine-checks against the source file at the claimed line. Nothing else ships. Kill-tested: 6.7% raw hallucination pressure on unfirewalled model output, 0% once the firewall runs.
04 · deliver
Cited, in seconds
Every surviving finding is file:line addressable — cents of inference standing in for minutes of subagent exploration, with a quote attached instead of a promise.
Install
Homebrew
brew install treygoff24/tap/scoutShell installer — prebuilt binary, no toolchain needed
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/treygoff24/scout/releases/latest/download/scout-cli-installer.sh | shCargo
cargo install scout-cliConfigure
Set the key, run the doctor, done.
- CEREBRAS_API_KEY required
- indexing + extraction — get one at cloud.cerebras.ai (SCOUT_API_KEY works as a fallback)
verify your setup
scout doctorHow it works
- scout index builds a two-tier card per file: a machine-verified skeleton (symbols, import edges, git churn, heading outlines) plus a model-written summary labeled as a hint, never delivered as fact.
- Cards are hash-keyed and reused across runs — only new or changed files cost money; the index lives in .scout/ as immutable generations with an atomic pointer.
- Queries route against the index to a candidate file set, extract facts per chunk, and keep only findings whose quote verifies against the source file at the claimed line.
- Every paid command prints a cost estimate before spending and asks for confirmation; --max-dollars is a hard cap that still returns a valid envelope.
- Kill-tested: 6.7% raw hallucination pressure on unfirewalled model output, 0% after the quote firewall.
Pairs well with
Known limits
- The hydration token-savings A/B (M2) awaits human-validated paired runs — measured gates cover recall, coverage, and hallucination, not yet end-to-end session savings.
- PDF/docx adapters are implemented but not yet run through a full predeclared evaluation.