name: sessions description: Manage and review session history and state user-invocable: true
/sessions
View, search, and manage saved session states and checkpoints.
Arguments
$ARGUMENTS— Subcommand:list,show <id>,resume <id>, orclean
Subcommands
list
Show recent sessions with status and summary.
| # | Date | Branch | Status | Summary |
|---|------|--------|--------|---------|
| 1 | 2026-02-05 | staging | clean | Added auth middleware |
| 2 | 2026-02-04 | feature/api | dirty | WIP: API rate limiting |
show
Display full details of a saved session including:
- Checkpoint state
- Pending tasks
- Context notes
- Uncommitted changes
resume
Restore session context and continue work:
- Check out the session's branch
- Load pending tasks
- Display context and next steps
- Begin work
clean
Remove sessions older than 30 days after confirmation.
Session Storage
Sessions are stored as markdown files in .claude/sessions/ or
~/.claude/sessions/ with naming convention:
session_YYYY-MM-DD_<slug>.md