| name | session-management |
| description | Manages Claude Code sessions with naming, checkpointing, and resume strategies. Use when organizing long-running work or resuming across sessions. |
| alwaysApply | false |
| category | workflow |
| tags | ["session","resume","checkpoint","debugging"] |
| tools | [] |
| complexity | low |
| model_hint | fast |
| estimated_tokens | 400 |
Session Management
When To Use
- Managing session checkpoints and state preservation
- Resuming work across Claude Code sessions
When NOT To Use
- Short sessions that do not need checkpoints
- Fresh starts where no prior session context exists
Overview
Claude Code supports named sessions for better workflow organization. Use this skill to manage complex, long-running work across multiple sessions.
Available Commands
| Command | Description |
|---|
/rename | Name the current session (auto-generates name if no argument given, 2.1.41+) |
/resume | Resume a previous session (REPL) |
claude --resume <name> | Resume from terminal |
Workflow Patterns
1. Debugging Sessions
Name debug sessions for easy resumption:
# Start debugging
/rename debugging-auth-issue
# ... work on the issue ...
# If you need to pause, session is auto-saved
# Resume later:
claude --resume debugging-auth-issue
2. Feature Development Checkpoints
Create checkpoints during long feature work:
# After completing milestone 1
/rename feature-x-milestone-1
# Continue in new session
# Reference old session if needed
3. PR Review Sessions
For complex PR reviews that span multiple sittings:
# Start review
/rename pr-review-123
# Take breaks without losing context
# Resume:
claude --resume pr-review-123
4. PR-Linked Sessions (Claude Code 2.1.27+)
Sessions are automatically linked to PRs when created via gh pr create. Resume PR-specific sessions later:
# Resume session for a specific PR
claude --from-pr 156
claude --from-pr https://github.com/org/repo/pull/156
# Workflow: review → pause → resume with full context
/rename pr-review-156
# ... review work ...
# Later:
claude --from-pr 156
5. Investigation Sessions
When investigating issues that may require research:
# Start investigation
/rename investigate-memory-leak
# Pause to gather more info externally
# Resume with full context:
claude --resume investigate-memory-leak
Resume Screen Features
The /resume screen provides:
