ClaudeCodeMod

All shelves / Mods / Workflow

handoff-compact

By trytofly94

handoff-compact is a Claude Code workflow mod by trytofly94.

Replaces compaction with a structured handoff that a fork of the session writes, and saves that handoff as a file.

Draws

Install

The marketplace name is handoff-compact.

In Claude Code
/plugin marketplace add trytofly94/handoff-compact
/plugin install handoff-compact@handoff-compact
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.2.1
License
MIT
Repo stars
12
Last change
2026-10-03

What it can reach

  • Draws in the session
  • Reads usage or context figures
  • Calls another program on this machine

Needs Claude Code 2.1.287 or later with mods enabled. It answers compaction instead of Claude Code's summarizer. A fork of the session writes the handoff along a fixed outline. The fork reads the conversation from the prompt cache and has no tools. That call is on your own Claude plan or key, so this page does not list it as network access. If the fork fails, compaction goes back to Claude Code with the outline as its instructions. The handoff replaces the conversation and is also saved as Markdown. The default folder is ~/.claude/handoffs. The README does not say how to delete those files. The default trigger is core: Claude Code decides when, at its compact window. trigger self is off unless you set it. With self, the mod decides at a percent of the window, 70 by default. /compact classic compacts once the way Claude Code does without the mod. To switch the mod off, disable it in /plugin. precompute skip, the default, turns off Claude Code's background pre-compaction. Set precompute to core to leave it on. autoContinue never, the default, means the handoff follows as a prompt that asks only for an acknowledgement. An optional adapter executable is called with JSON on stdin. A missing adapter counts as no answer. In claude -p the hooks run, but nothing is drawn. The README does not name a drawing on the CLI or in the Desktop app. A checkout for one session is claude --plugin-dir with this folder.

The plugin is the repo root. The marketplace name is handoff-compact. With trigger set to self, source shows a toast that the compaction became a handoff and names the saved file. The default trigger is core, and the README does not name that toast. This page lists draws for that toast. compact-handoff, by REMvisual, writes a handoff, replaces the conversation, and toasts once context passes 70%. ctx-handoff, by cablate, hands a long session to a fresh conversation when the window fills. auto-handoff, by obie, writes a handoff file after idle and runs that handoff. This one replaces Claude Code's compaction summary with a handoff from a fork of the same session.

Demo

The handoff-compact section on the author's GitHub page
Screenshot of the author's GitHub page.

What it hooks into

  • session.compactWhen the context is compacted
  • session.measureWhen usage is measured
  • turn.completeWhen a turn ends

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

Files

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

Facts

Author
trytofly94
Category
Workflow
Marketplace
handoff-compact
Repo
trytofly94/handoff-compact
Version
0.2.1
License
MIT
Repo stars
12
Last change
2026-10-03
Language
JavaScript
Files
12

Other mods in Workflow

agentpanexuanji86Draws a side pane of every subagent, with its current tool, tokens, model, and effort, and its conversation one click away.repoqlRepoQLIndexes a repo through the RepoQL host so Claude can search its structure, and draws whether that host is ready or working.nomoreideRorogogogoDraws an optional side pane for NoMoreIDE, a local workbench for Git, services, and agents, by reading its daemon.mods-toolboxrube-deHolds a commandFour mods in one install: a plan checklist above the prompt in place of tool calls and diffs, cards for parallel helpers, a status line, and a settings popup.cli-dispatchrbinarHolds a commandHands a task to DeepSeek, Gemini, Codex, OpenCode, or Copilot, and draws this session's workers above the prompt.pinboardsirkitreeDraws open decisions, the session's todos, and links Claude creates in a side pane so they stay in view.kit-updatesVedantAndhaleToasts when a mod from claude-pro-kit is behind, and by default installs those updates at the start of each session.peekVedantAndhaleOpens a pane of background shells and subagents, with elapsed time and their last output lines.workflow-conductorbruwHolds a commandDraws a board where you plan an agent workflow, sends that plan to Claude when you press r, and shows the run's progress and token cost.godot-stagehandmrfFor Godot Stagehand, which drives a running Godot game, draws the connection and the last frame Claude captured.flowstatepicatzHolds a commandFor Flowstate, a workflow language, draws a pane of runs, checks a Flowfile after an edit, and asks before a flow command that changes a server.taxi-blackboxdevbrother2024Records Claude's tool calls like a taxi dashcam and opens the moments before an error or a refusal.
All 396 in Workflow