code-search

name	code-search
role	library
description	Searches GitHub for existing implementations, libraries, or patterns. Use when finding code examples or prior art on a topic during a research session.
alwaysApply	false
category	research
tags	["github","code","search"]
estimated_tokens	200
model_hint	standard

Code Search

When To Use

• Finding existing implementations or libraries on GitHub
• Part of a /tome:research session 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

1. Build search queries using tome.channels.github.build_github_search_queries()
2. Execute queries via WebSearch
3. Parse results via parse_github_result()
4. Optionally use GitHub API via build_github_api_search() for richer metadata
5. Rank via rank_github_findings()
6. 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