Code Search
When To Use
- Finding existing implementations or libraries on GitHub
- Part of a
/tome:researchsession or standalone search
When NOT To Use
- Searching local codebase (use Grep or Explore agent)
- Academic literature (use
/tome:papers)
Search GitHub for implementations of a given topic.
Usage
Invoked as part of /tome:research or standalone.
Workflow
- Build search queries using
tome.channels.github.build_github_search_queries() - Execute queries via WebSearch
- Parse results via
parse_github_result() - Optionally use GitHub API via
build_github_api_search()for richer metadata - Rank via
rank_github_findings() - Return Finding objects
Exit Criteria
- [ ] At least one GitHub search query built and executed via WebSearch for the requested topic
- [ ] Results parsed into Finding objects containing repo metadata (name, URL, stars) and a relevance score
- [ ] Findings returned from
rank_github_findings()sorted by relevance score descending - [ ] If no results are found for the query, this is reported explicitly rather than returning an empty list silently