ClaudeCodeMod

All shelves / Mods / Workflow

ctx-handoff

By cablate

ctx-handoff is a Claude Code workflow mod by cablate.

Keeps the cache warm while you are away, turns what you teach Claude into project notes, and can hand a full session to a fresh conversation.

DrawsHolds a command

Install

The marketplace name is ctx-handoff-mod.

In your shell
claude plugin marketplace add cablate/ctx-handoff-mod
claude plugin install ctx-handoff@ctx-handoff-mod
Open the repo

It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.

Version
0.8.2
License
MIT
Repo stars
122
Last change
2026-10-18

What it can reach

  • Draws in the session
  • Reads usage or context figures
  • Holds a command
  • Sees tool calls

Claude Code 2.1.287 or later, tested up to 2.1.302. The author says it is experimental, since mods are in early access, and built for Claude subscriptions and long sessions; on an API key, Bedrock, or Vertex the cache lasts 5 minutes, so run /handoff refresh off. Start a new session and type /handoff to see the context, the threshold, and the refresh state. Auto handoff is off by default, so Claude Code's own compact takes over. With auto_handoff on, at 600k tokens, or 80% of a smaller window, it waits for Claude and its subagents to finish, writes a summary that keeps verified work apart from unverified changes, lists what failed and the limits you set, ends with one next step, clears, and continues in a fresh conversation. After about 50 idle minutes it sends a tiny request to keep the cache warm, up to 3 times, then saves a summary without clearing, and your first message back is held until you pick /handoff resume or /handoff continue. Preferences, corrections, and facts become one Markdown notes file per project in ~/.claude/projects/, updated every 30 of your messages by Sonnet 5.5 at low effort, from the new part of the conversation only. Once you have had to say a rule 3 times, the next conversation in a git repo has Claude put it in CLAUDE.md, AGENTS.md, or an existing hook and tell you in one line where; it does not commit, and saying no undoes it. Nudges tell Claude when a tool fails twice for the same reason, or when it says done without a passing check. A guard is a check on tool calls, drafted from a rule that keeps getting broken, that reminds or blocks; nothing applies until you say yes. /handoff panel opens a panel above the prompt for guards, memories, rules, the latest notes update, and every setting. The author says it runs on your Claude Code sign-in and sends nothing anywhere but Anthropic.

The repository is its own marketplace, ctx-handoff-mod, and ctx-handoff is its only plugin. Update it with claude plugin update ctx-handoff@ctx-handoff-mod. Picking a long session back up is why this page files it under workflow. handoff-compact, by trytofly94, replaces compaction with a structured handoff that a fork of the session writes, and saves it as a file. cache-keeper-nateherkai draws whether this chat's prompt cache is warm or cold, and can keep a big chat warm. This one does both, and also keeps project notes and drafts guards from what you correct.

Demo

Animation: a long session fills its context to the threshold; ctx-handoff writes a summary of verified work, failed attempts, your limits and the next step, clears, and a fresh session continues from it
From the author's repo.

What it hooks into

  • session.startWhen a session starts
  • session.endWhen a session ends
  • turn.stepAt each step of a turn
  • config.setA Claude Code event
  • prompt.contextA Claude Code event
  • tool.callAround a tool call, where it can hold one
  • ui.renderDraws into the sessionAbovePrompt
  • turn.completeWhen a turn ends
  • classic.StopA Claude Code event
  • prompt.submitWhen you send a prompt
  • command.runWhen you run its slash command

Read from the on() calls in its hook modules. Open its source under Files to check what each one does.

Slash commands 2

  • /handoff
  • /ctx-handoff

Files

The author's README and source, 4 files. They load when you open them.

Facts

Author
cablate
Category
Workflow
Marketplace
ctx-handoff-mod
Repo
cablate/ctx-handoff-mod
Version
0.8.2
License
MIT
Repo stars
122
Last change
2026-10-18
Language
TypeScript
Files
97

Other mods in Workflow

mod-storehellosverreOpens /mods, a pane that browses and searches community mods, shows what each one can access, and installs one when you press Install.supermemorysupermemoryaiGives Claude memory across sessions through Supermemory, with a recall strip above the prompt that shows what it found for your prompt.remctlviticciDraws today's Apple Reminders above the prompt in your lists' colors, with a /reminders pane where ✓ completes a task, and gives Claude RemCTL's tools.code-modernizationAnthropicAdds a live pane to Anthropic's code-modernization plugin: the map of your legacy code, how far each part has got, each module's proof verdict, and what to run next.auto-handoffobieWrites a handoff file after the session sits idle, runs that handoff as if you typed it, and toasts when it does.dream-passray-amjadTidies Claude's memory folder, merging duplicates and dropping dead entries, and shows the counts in a band with a pane, a backup, and undo.snippetsSingh-APKeeps saved prompts and drops one into the prompt box with /snip, with the branch, the date, and your last selection filled in.answer-paneVedantAndhaleDraws explain, plan, and ELI5 pages in a side pane, with decision buttons on a plan and Respond filling the prompt box.plan-progresszycckDraws live progress bars above the prompt, one row per task with its stages, steps, and the subagents under it.open-askserikdarlingdataDraws each question the session is waiting on in a band above the prompt, with the recommended answer, until you answer or drop it.conversation-atlasNeelAPatelOpens a side pane that maps the session: the goal, the current path, detours, decisions, open questions, and what to resume next.asideJayDoubleuOpens a pane beside the transcript where you ask about the session so far, answered by a tool-less fork that writes nothing back.
All 396 in Workflow