find-sessionlisted
Install: claude install-skill kauffj/agent-config
# Find a Claude Code Session
You are searching the user's Claude Code session transcripts to find the
session(s) they're thinking of. They often have 15+ terminal windows with
active sessions and remember only a fragment of what was said.
**Query:** $ARGUMENTS
## Tool
Use the search script that ships with this config (no other transcript
spelunking needed):
```
$HOME/.claude/bin/claude-search PATTERN [--all] [--since 6h|2d|1w] [-m N] [--paths]
```
- Searches the user + assistant text of session transcripts — what the user
could scroll through in a terminal, not tool payloads — across Claude, Codex
and Grok.
- PATTERN is a Python regex, always case-insensitive.
- **Scope defaults to LIVE sessions only.** Pass `--all` to sweep history; that
is the right default for "find the session where we…" questions about
anything older than the tabs open right now.
- `--since 6h|2d|1w` limits by how recently the transcript was touched.
- Each hit prints the session id, project directory, match count, last-active
age, the opening prompt (this is what identifies the terminal window),
matching lines, and the exact command that reopens it.
- Exit code is nonzero with a "no matches" message when nothing hits.
**Optional local extra.** If `$HOME/projects/claude-beep/claude-grep` exists on
this machine, it can additionally point at the tab:
`claude-grep --mark <session-id-prefix>` renames that session's terminal tab to
`🎯 <project> — FOUND 🎯` and rings its bell; `--unmark <pr