sessionslisted
Install: claude install-skill phnx-labs/.agents
# Sessions Skill
Search and browse agent conversation transcripts. This skill teaches you how to use the `agents sessions` CLI effectively.
## Basic Usage
```bash
# Interactive picker: browse and search recent sessions
agents sessions
# List sessions from current project
agents sessions | head -20
# Search sessions by text
agents sessions "add auth middleware"
# Filter by project across all directories
agents sessions --project agents-cli --all
```
## Resume & Fork (session lifecycle)
`agents sessions resume` and `agents sessions fork` are the canonical lifecycle path —
the `sessions` plugin skills drive them: `/continue` and `/recover` → `sessions:continue`,
`/fork` → `sessions:fork`. Prefer those skills over hand-rolling resume flags.
```bash
# Resume — reopen the SAME conversation by canonical id (from any device)
agents sessions resume 019fd114 # reopen one, full context
agents sessions resume 019fd114 --device zion # scope identity to the owning device
agents sessions resume # picker: multi-select into tabs/splits
# Fork — copy a session under a NEW id so the two diverge (original untouched)
agents sessions fork 4f3a9c21 # prints: Forked <src> -> <new-id>
agents sessions fork 4f3a9c21 --name "try redis" # label the branch
agents sessions resume <new-id> # then continue the fork
```
- **resume vs fork:** `resume` continues the *same* thread; `fork` copies it under a new id so the two