save-thread
Save complete conversation as checkpoint. Only when user explicitly requests ("save session", "checkpoint this"). Use thread_persist to store full message history with summary.
When & Why to Use This Skill
The Save Thread skill is a specialized utility designed for Claude Code users to create persistent checkpoints of their AI interactions. By utilizing the nmem-cli, it allows for the explicit saving of complete conversation histories, including summaries and metadata, ensuring that critical development context is preserved and easily retrievable for future sessions.
Use Cases
- Session Checkpointing: Manually trigger a save during complex debugging or refactoring tasks to create a 'restore point' of the current logic and progress.
- Knowledge Archiving: Export full Claude Code sessions into a structured format to document technical decisions and implementation details for team review.
- Context Resumption: Seamlessly import previous conversation threads into new environments using project-specific IDs to maintain continuity in long-term software projects.
- Workflow Optimization: Use the distilled summaries of saved threads to quickly recap project status without re-reading entire message histories.
| name | Save Thread |
|---|---|
| description | Save complete conversation as checkpoint. Only when user explicitly requests ("save session", "checkpoint this"). Use nmem t save to automatically import Claude Code sessions. |
Save Thread
When to Save
Only when user explicitly says: "Save this session" | "Checkpoint this" | "Record conversation"
Never auto-save or suggest.
Tool Usage
Use nmem t save to automatically import the current Claude Code session:
# Save current session for current project
nmem t save --from claude-code
# Save with custom summary
nmem t save --from claude-code -s "Brief summary of what was accomplished"
# Save all sessions for current project
nmem t save --from claude-code -m all
# Save for specific project path
nmem t save --from claude-code -p /path/to/project
Options:
--from: Source app (claude-codefor Claude Code)-s, --summary: Optional brief summary (recommended)-m, --mode:current(default, latest session) orall(all sessions)-p, --project: Project directory path (defaults to current directory)--truncate: Truncate large tool results (>10KB)
Behavior:
- Auto-detects sessions from
~/.claude/projects/ - Idempotent: Re-running appends only new messages
- Thread ID: Auto-generated as
claude-code-{session_id}
Thread vs Memory
Thread = full history | Memory = distilled insights (different purposes, can do both)
Response
✓ Thread saved
Summary: {summary}
Messages: {count}
Thread ID: claude-code-{session_id}
Troubleshooting
If nmem is not available:
Option 1 (Recommended): Use uvx
# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
# Run nmem (no installation needed)
uvx --from nmem-cli nmem t save --from claude-code
Option 2: Install with pip
pip install nmem-cli
nmem t save --from claude-code