claude-skills / claude-continuation
Sessions · MIT · for Claude Code

claude-continuation

Never re-explain your project to Claude again. Three slash commands give Claude Code memory across sessions: /end captures where you left off, /continue picks it back up, and /next opens the next session in a fresh terminal. Beat context limits with zero recap and zero lost momentum.

Get started → Source ↗
A session handoff note saved to disk on Day 1 and read back on Day 2, so Claude resumes with no recap Day 1 · /end Day 2 · /continue
/end writes a handoff to disk → /continue reads it back → you’re in flow in ~5s
// what it is

What claude-continuation does

A tiny, dependency-free plugin that adds three slash commands. That’s the whole thing — no linting, no commits, no automation. Just handoff, resume, and launch, so a future session picks up exactly where the last one stopped.

command

/end

Before you stop, Claude writes a short handoff to disk: what got done, what’s unfinished, the exact next step, and the key files.

command

/continue

Next time, Claude reads the latest handoff, sanity-checks your git state, and orients you in about five seconds. Read-only — it never writes.

command

/next

Opens the next session in a fresh terminal (worktree-aware), auto-running /continue, with a distinct colour + title so parallel worktrees are easy to tell apart. macOS.

// the 5 W’s & 1 H

Everything, at a glance

What it is, why it exists, when to use it, who it’s for, where it stores things, and how a full cycle goes.

What

Session handoffs

Three slash commands — /end, /continue, /next — that persist a session’s state to disk and resume it cleanly later.

Why

Kill the daily recap

Open a project and Claude has no memory of yesterday — you waste ten minutes re-explaining. This removes that, and lets you reset a full context window without losing the thread.

When

End, resume, branch out

Run /end before you stop, /continue when you return, and /next when you’re juggling several git worktrees and want one labelled session each.

Who

Any Claude Code dev

Any language, any stack, solo or team. No dependencies, no runtime. Works in git repos and plain directories alike.

Where

Your project, on disk

Handoffs live in .claude/continuations/ and optional gotchas in .claude/learnings/ — one file per session, dated. Nothing leaves your machine.

How

Capture → resume → launch

/end captures & confirms then writes; /continue finds, reality-checks git, and orients; /next opens the next labelled window. Read on for the full cycle.

// how it works

The handoff cycle

The natural loop is /end/next/continue. Each command does one job, well.

The cycle: /end writes a handoff, /next opens a fresh terminal, /continue resumes from the handoff /end /next /continue write handoffopen windowresume in 5s

/end — capture & confirm, then write

Claude reviews your git branch, recent commits, uncommitted changes, and the conversation; drafts a handoff for you to confirm; then writes .claude/continuations/YYYY-MM-DD-{topic}.md (and a learnings file only if something non-obvious came up). No commits, no lint.

/continue — find, reality-check, orient

Reads the most recent handoff, runs read-only git status/git log to flag branch mismatches or new commits, and prints a tight orientation: what was done, where you left off, the next task, the key files. It writes nothing.

/next — launch the next session

Picks a target worktree, detects your terminal (Terminal.app, Ghostty, iTerm2, Warp), and opens a new window at that directory with a stable per-worktree colour + title, auto-running /continue. macOS only; it only launches — never commits.

// where it lives

One file per session, dated

Filenames start with the date, so ls produces a natural timeline. It’s your call whether to commit them — gitignore them for private notes, or commit for team-wide session history.

Private by default. The plugin only writes local files. Nothing is sent anywhere external.
your-project/
└── .claude/
    ├── continuations/
    │   ├── 2026-05-27-user-profile-endpoint.md
    │   ├── 2026-05-28-fix-validation-bug.md
    │   └── 2026-05-30-add-pagination.md
    └── learnings/
        └── 2026-05-27-zod-error-handler.md
// scope

What it is — and isn’t

The scope is intentionally narrow. Keeping each command sharp on its one job is the whole point. Pair it with other commands for the rest.

Use it for

  • Ending a session so tomorrow’s you starts instantly.
  • Resuming after a break with no recap.
  • Resetting a near-full context window without losing the thread.
  • Running several git worktrees, one labelled session each.

It does NOT

  • Lint or format your code.
  • Commit or push anything.
  • Run code review.
  • Auto-trigger on session end — you run /end yourself.
// get started

Install claude-continuation

Add the marketplace once, then install the skill. After installing, type / — you’ll see /end and /continue in the autocomplete.

$/plugin marketplace add amjad1233/claude-skills
$/plugin install claude-continuation@amjad1233
Read the commands & full README ↗
Next skill: agent-army →