Slash Command95 repo starsupdated 6d ago

save-handoff

The save-handoff command creates a structured markdown file in `.aspens/sessions/` containing task summary, current progress, affected files, risks, and next steps, enabling future Claude sessions to resume work efficiently. Use this when pausing extended projects to preserve context and maintain continuity across separate coding sessions.

View source Repository: aspens

Install in Claude Code

Copy

mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/aspenkit/aspens/HEAD/.claude/commands/save-handoff.md -o ~/.claude/commands/save-handoff.md

Then start a new Claude Code session; the slash command loads automatically.

Definition

save-handoff.md

Write a structured handoff file to `.aspens/sessions/` so a future Claude session can continue this work.

## Steps

1. Generate a timestamp: `YYYY-MM-DDTHH-MM-SS` (replace `:` and `.` with `-`).
2. Write a markdown file to `.aspens/sessions/<timestamp>-claude-handoff.md` with this structure:

```md
# Claude save-tokens handoff

- Saved: <ISO timestamp>
- Reason: user-requested
- Working directory: <cwd>

## Task summary

<1-3 sentences: what you were working on and why>

## Current state

<What's done, what's in progress, what's blocked>

## Files touched

<List of files created, modified, or deleted in this session>

## Risks and open questions

<Anything the next session should watch out for>

## Next steps

<Concrete next actions to continue this work>
```

3. Update `.aspens/sessions/index.json` with `{ "latest": "<relative path>", "savedAt": "<ISO>", "reason": "user-requested" }`.
4. Confirm the handoff was saved and print the file path.