# Session Save

> Save a source-attributed mid-session checkpoint into the shared local Session Save home. Use when the user asks to save, checkpoint, preserve current state, or pause unfinished work. Not an end-of-session close-out.

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

---


# Session save — checkpoint

Resolve this skill directory as `SKILL_DIR`. Read `CLIENT.md` beside this file for the installed `client_id`. Read the shared home’s `GUIDE.md`.

1. Run `python3 "$SKILL_DIR/scripts/session_save.py" doctor --client <client_id>`. Stop unless `ok` is true and `migration_required` is zero.
2. Locate the current record with `locate --client <client_id> --session-id <id>` when a real stable host ID exists, otherwise `locate --client <client_id> --slug <known-slug>`.
3. If no record exists, run `project-list` and resolve one exact approved project. Ask on ambiguity; never infer identity from tags or similar keywords. Register a genuinely new project only after explicit confirmation. Then run `begin --client <client_id> --project <project> --name <name> --status provisional --gist "Checkpoint saved; run session-tag to tag this session." --require-registered-project`. Never invent a verdict or an unconfirmed project. This is the single provisional record.
4. Run `checkpoint-path --client <client_id> --record <record>` and write one Markdown checkpoint to the returned unique path. Use `### <HH:MM> — <client_id>` followed by **Now**, **Working on**, **Next**, and **Watch**. Keep it approximately 100–300 words.
5. Run `sync --client <client_id> --record <record> --operation checkpoint-written`. Do not change an existing open record back to provisional.
6. Print the compact checkpoint receipt with the client label and real path.

Checkpoints are immutable event files. Never append to another client’s file, create a second record for the same client session, write a close-out here, or edit `_INDEX.md` directly.