session-searchlisted

## Context - Current directory: !`pwd` - Git repo root: !`git rev-parse --show-toplevel 2>/dev/null || echo "NOT_IN_GIT"` - Repo name: !`basename $(git rev-parse --show-toplevel 2>/dev/null) 2>/dev/null || echo "UNKNOWN"` # Session Search Searches session transcripts across all detected coding agents: Claude Code, Codex CLI, Gemini CLI, Goose, and Amp. Results are ranked by current repo match, then by recency. ## Quick Start Resolve `<skill-dir>` as the directory containing this SKILL.md file. ```bash # Find sessions by title, ID fragment, or cwd (metadata only — use grep for content) PYTHONPATH=<skill-dir>/scripts uv run python -m session_search find "authentication" # Search transcript content for a regex pattern PYTHONPATH=<skill-dir>/scripts uv run python -m session_search grep "authentication refactor" --limit-sessions 20 # List recent sessions for the current repo PYTHONPATH=<skill-dir>/scripts uv run python -m session_search list --limit 10 ``` ## Context Hygiene For broad or exploratory searches, delegate to a subagent and return only IDs, titles, timestamps, cwd values, paths, and short snippets. Never dump raw transcripts into the main context window — a single session file can be hundreds of kilobytes. When returning results to the user, summarize what was found and offer to retrieve specific sessions on request. ## Find Sessions ```bash # Look up a session by ID fragment PYTHONPATH=<skill-dir>/scripts uv run python -m session_search find "3f8a" # Fin