Supersession

Your AI coding session, superseded — hand it off to any tool and keep going.

Hit your Claude Code limit mid-task? Switching machines? Handing work to a teammate? sup reads your current session, distills it into a repo-grounded continuation brief, and writes it in the format the next tool expects — so the new agent continues instead of restarting.

npm i -g @supersession/sup

# wire it into every AI tool on your machine (Claude Desktop/Code, Cursor,
# Codex, Windsurf, VS Code, Antigravity) — drive it from inside them, no terminal:
sup install      # Claude Code gets /sup-refresh + /sup-handoff; elsewhere just ask

# your long session got dumb (context rot)? start fresh WITHOUT losing the arc:
sup status       # session health: size + rot signals
sup refresh      # fresh window, full arc — distills the complete on-disk
                 # transcript, not the degraded live window like /compact

# hit your Claude Code limit mid-task? continue in another tool:
sup codex        # writes AGENTS.md; Codex picks up where Claude left off
sup preview codex   # see the exact brief first — writes nothing

# plan on your phone in ChatGPT, build on your machine:
sup import chat.json claude

sup list         # what session sup sees for this directory

How it works

discover → parse → redact → distill → write

1. discover — find the current directory's latest session
2. parse — into the Neutral Session Format (NSF), a tool-agnostic shape
3. redact — strip API keys / secrets locally before anything moves
4. distill — a continuation brief: goal, files touched (checked against the live repo), commands run, recent turns verbatim, next step
5. write — the target tool's native kickoff file (AGENTS.md, CLAUDE.local.md, GEMINI.md)

Every handoff prints a fidelity report: what carried verbatim, what was summarized, what was dropped, how many secrets were redacted. Lossy on purpose, never silently.

Status

v0.1 — local handoff engine + cloud vault. Source parsers (verified): Claude Code, Codex CLI, Cursor — sup reads whichever you worked in last. Targets: Claude Code, Codex, Cursor, Gemini, Antigravity. Sessions carry a title + summary and version on re-push (v1, v2, …), browsable in the web dashboard. sup facts surfaces the credentials/URLs a session generated, locally. Web-chat import and teams are on the roadmap (see SPEC.md).

Develop

pnpm install
pnpm test        # unit tests with a schema-faithful fixture
pnpm build       # tsc -> dist/
pnpm dev list    # run the CLI from source

MIT.