session-search
FeaturedFor CLI agents WITHOUT subagent support (e.g., Codex CLI). Search previous code agent sessions for specific work, decisions, or code patterns.
AI & Automation 1,997 stars
130 forks Updated 3 days ago MIT
Install
Quality Score: 93/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
> **If you are Claude Code:** Do NOT use this skill directly. Use the
> `session-searcher` subagent via the Task tool instead - it handles this more
> efficiently without polluting your context.
# session-search
Search and find previous code agent sessions (Claude-Code or Codex-CLI) for specific
work, decisions, or code patterns.
## Workflow
1. **Understand the query**: Identify what the user is looking for (code patterns,
decisions, specific work, design direction)
2. **Search with aichat**: Run `aichat search --json -n 10 "[query]"` (use
`-g "project"` to filter by project)
3. **Parse results**: Use `jq` to extract fields from JSONL output (session_id,
project, created, snippet, file_path)
4. **Deep dive if needed**: Read session files at
`~/.claude/projects/*/[session-id].jsonl` (max 3 files)
5. **Summarize**: Return a focused summary with key findings and references
Run `aichat search --help` to see all options (date filters, branch filters, etc.)
and JSONL field names.
## Output Format
Return a concise summary containing:
1. **Key Findings**: 2-3 bullet points answering the query
2. **Relevant Sessions**: Session IDs and dates for reference
3. **Specific Content**: Code snippets or quotes if directly relevant
Format as clean markdown, not raw JSON.
## Example
Query: "Find sessions where we discussed authentication design"
```bash
aichat search --json -n 10 "authentication design"
```
Summary:
- **Session abc123** (Dec 10): Discussed JWT vs sessio...
Details
- Author
- pchalasani
- Repository
- pchalasani/claude-code-tools
- Created
- 1 years ago
- Last Updated
- 3 days ago
- Language
- Python
- License
- MIT
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Listed
session-search
Search past Claude Code, Pi, and Codex conversations by topic, file, project, decision, tool use, skill use, subagent runs, questions, and File Mutations
0 Updated 1 months ago
rolandtolnay AI & Automation Listed
sessions
Search, browse, and read agent conversation transcripts across Claude, Codex, Gemini, and OpenCode. Use this skill to find previous sessions, recover context, or inspect what agents have done.
16 Updated 2 weeks ago
phnx-labs