| name | session-search |
| description | For CLI agents WITHOUT subagent support (e.g., Codex CLI). Search previous code agent sessions for specific work, decisions, or code patterns. |
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
- Understand the query: Identify what the user is looking for (code patterns,
decisions, specific work, design direction)
- Search with aichat: Run
aichat search --json -n 10 "[query]" (use
-g "project" to filter by project)
- Parse results: Use
jq to extract fields from JSONL output (session_id,
project, created, snippet, file_path)
- Deep dive if needed: Read session files at
~/.claude/projects/*/[session-id].jsonl (max 3 files)
- 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:
- 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
Format as clean markdown, not raw JSON.
Example
Query: "Find sessions where we discussed authentication design"