Description
caveman-explore is a read-only repository explorer from the caveman project, meant for cold-start orientation, broad cross-file localization, and cases where a direct search has failed. It is written as a fast, cheap explorer. Another agent hands it a localization question, and it reports where the relevant code lives as a compact list of file paths with line ranges. It never edits files, runs commands or proposes a solution. Its method is to fan out: on the first turn it issues several searches and reads in parallel, covering likely path patterns, symbol and string matches, and the most promising files, and it follows the evidence for only a turn or two more if needed. It must cite only line ranges it has actually read, never invent or estimate a range, and never cite a range past the end of a file. The instructions say a precise small range is better than a vague large one. The skill also says to skip it when the exact file or symbol is already known, since a direct lookup is faster. It suits agents that want to save their own token budget while locating code in an unfamiliar repository.…
Highlights
- Read-only code localization
- Parallel searches on the first turn
- Cites only line ranges it has read
- Compact file and line-range output
Ratings & Reviews
No ratings yet
Be the first to rate caveman-explore.
People also visit
caveman-explore FAQ
What does the caveman-explore skill do?
It is a read-only explorer that finds where relevant code lives in a repository and reports file paths with line ranges.
How do I install it?
Run: npx skills add https://github.com/juliusbrussee/caveman --skill caveman-explore
Can it change files?
No. It is read-only. It never edits files, runs commands or proposes a solution.
When should I skip it?
When the exact file or symbol is already known, because a direct lookup is faster.
What security checks has it passed?
skills.sh lists three audits: Gen Agent Trust Hub Pass, Socket Pass and Snyk Pass.
What are the best caveman-explore alternatives?
Popular alternatives to caveman-explore include build-graph, github and mcporter. See all caveman-explore alternatives