# Save Thread

> Create a structured handoff summary when the user asks for a checkpoint. PI transcript sync is automatic; this skill adds a concise continuation record.

- Skill: `cnife/save-thread` (Agent Skill)
- Install (CLI): `npx skillmds@latest add cnife/save-thread`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cnife/save-thread/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: cnife (https://skillmd.com/u/cnife)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cnife/save-thread

---


# Save Thread

The nmem-lite extension automatically syncs completed PI conversations as searchable threads. This skill creates a structured handoff summary when the user wants a concise checkpoint for a future session.

## When to Use

- User asks to save the session: "save this", "checkpoint", "record what we did"
- Session ending with important context that should carry forward
- Complex multi-step work that a future session will resume

Do not use this as routine transcript sync. Use it only when a curated handoff would help a future session resume quickly.

## Usage

```bash
nmem --json t create \
  -t "Session Handoff - <topic>" \
  -c "Goal: ... Decisions: ... Files: ... Risks: ... Next: ..." \
  -s generic-agent
```

## Content Format

Structure the content as a clear handoff. Include only what a future session needs to continue:

```text
Goal: What the session set out to accomplish
Decisions: Key choices made and their rationale
Files: Important files created or modified
Outcome: What was achieved
Risks: Known risks, open questions, or things that could break
Next: Concrete steps for the next session
```

### Example

```bash
nmem --json t create \
  -t "Session Handoff - Auth Migration to OAuth2" \
  -c "Goal: Migrate session auth from JWT to OAuth2 with PKCE.
Decisions: Chose Authorization Code flow with PKCE over Implicit for security. Using passport-oauth2 library.
Files: src/auth/oauth2.ts (new), src/auth/middleware.ts (updated), tests/auth.test.ts (updated).
Outcome: Core flow working, token refresh implemented, tests passing.
Risks: Token refresh not tested under clock skew; CSRF state parameter still missing.
Next: Add CSRF state parameter, update API docs, deploy to staging." \
  -s generic-agent
```

## Thread vs Memory

A thread preserves session structure: goals, sequence, context. A memory distills a single insight or decision. They serve different purposes. Use both when appropriate: save the thread for continuity, distill key decisions as standalone memories.

## Links

- [Documentation](https://mem.nowledge.co/docs/integrations/omp)
- [Troubleshooting](https://mem.nowledge.co/docs/troubleshooting)