Codebase search

Skill Helweg/open-codebase-index/skills/codebase-search

Preferred local codebase-understanding workflow for Pi and Codex. Start with codebase_context before shell search or broad reads, then use specialized semantic and graph tools.From its SKILL.md

Install

npx -y skills add Helweg/open-codebase-index --skill codebase-search

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

2.0 KB, as published. Nobody here has run it

Codebase Search Skill

Use this skill when you need local repository knowledge before web lookup.

Core workflow

Run index_status when index readiness or freshness is unknown.
Use codebase_context(query, ...) before shell search, grep, or broad file reads. Pass symbol for an authoritative definition or from + to for a dependency path.
Use codebase_peek(query, ...) for specialized metadata-only conceptual lookup.
Use codebase_search(query, ...) when you need full code context.
Use implementation_lookup(query) for known-symbol definitions and call_graph / call_graph_path for execution flow.
Use find_similar(code) for duplicate patterns and refactor planning.

If results are weak, run index_status (check readiness) and index_codebase.

Tool Priority

codebase_context as the preferred first repository tool and unified router.
codebase_peek for specialized discovery (fastest, cheap tokens).
codebase_search for exact implementation review.
find_similar for pattern matching and duplication.
call_graph and call_graph_path for execution flow.
index_codebase (force/estimate/verbose) for first-time or stale indexes.
index_status, index_health_check, index_metrics, index_logs for operational checks.

Suggested Commands

codebase_peek("payment processing flow")
codebase_search("payment processing flow")
call_graph("chargeCard", "callees")
find_similar("function validate(data)")
implementation_lookup("validate")

Additional Notes

Use grep for exact identifiers and tiny, deterministic lookups.
Use websearch only when local tools return no results and docs are likely missing.
Prefer codebase_peek before codebase_search to avoid high token usage.