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.

⭐12stars🔀0forks📁View on GitHub🕐Updated Dec 9, 2025⬇️2downloads

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.
nameSave Thread
descriptionSave 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-code for Claude Code)
  • -s, --summary: Optional brief summary (recommended)
  • -m, --mode: current (default, latest session) or all (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