Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add agents/pchalasani/claude-code-tools/session-searchergit clone --depth 1 https://github.com/pchalasani/claude-code-toolsWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00064 | $0.00922 |
| Opus 5 | $0.00032 | $0.00461 |
| Sonnet 5 | $0.00013 | $0.00184 |
| Haiku 4.5 | $0.00006 | $0.00092 |
Grade A, and why
session-searcher scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
Copies of this mod
1 near-identical copy found in the catalogue:
- session-searcher — 94% identical, 9 lines differ
How it starts
The opening of the file, as written. The whole thing — 89 lines — stays where its author put it; the contents beside it link to each section on GitHub.
-
Choose your approach:
Path A — Direct examination (when session file is already known):
- If a specific file path was provided, or context makes it obvious which session to examine, go directly to that file.
- Read the session file and extract the relevant information.
- Skip to step 3.
Path B — Search first (when you need to discover sessions):
- Run
aichat search --json -n 10 "[query]"(use-gfor global,--dir "project"to filter) - Parse results with
jqto extract: session_id, project, created, snippet, file_path - Read session files at the
file_pathfrom results (max 3 files) - Run
aichat search --helpto see all options (date filters, branch filters, etc.)
-
Verify if needed: If referencing current codebase files (TO-DOS.md, etc.), read them to confirm current state
-
Summarize: Return a focused summary with key findings and session references
<output_format> Return a concise but comprehensive summary containing:
- Key Findings: 2-3 bullet points answering the query
- Relevant Sessions: Session IDs and dates for reference
- Specific Content: Code snippets or quotes if directly relevant
- Context: Brief explanation of how findings relate to query
Format as clean markdown, not raw JSON. </output_format>
Search: aichat search --json -n 10 "authentication design"
Summary:
Key Findings
- Session abc123 (Dec 10): Discussed JWT vs session-based auth, decided on JWT for API
- Session def456 (Dec 8): Implemented refresh token rotation pattern
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 89 lines · 64 tokens per session scan A c12220a7f9bf
session-searcher is an agent published in the GitHub repository pchalasani/claude-code-tools (1,989 stars, last pushed 2d ago), licensed MIT. It adds 64 tokens to every session and 922 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other agents, from other repositories
manager
QA manager that coordinates dev and qa agents via tmuxy events and GitHub Issues.
investigation-agent
Bug investigation specialist. MUST BE USED when PM Bug Fix requests bug investigation. Reads context from investigation-context.json and outputs investigation-result.json. Analyzes error logs, identifies root cause, and recommends solutions.
codex
Configure OpenAI Codex as your AI coding agent.
analyzer
Analyze blind comparison results to understand WHY the winner won and generate improvement suggestions.
i18n
Multiplex ships English (source), Traditional Chinese (zh-Hant, Taiwan wording) and Japanese (ja). Decisions below were settled 2026-08-18; do not re-litigate without new facts.
progress-report-agent
Progress reporting specialist. MUST BE USED when PM Auto-Dev requests progress report generation. Reads context from progress-context.json and outputs progress-report.md. Summarizes all phase results and suggests next steps.