ClaudeCodeMod

All shelves / Mods / Workflow

handoff-runner

By Hangghost

handoff-runner is a Claude Code workflow mod by Hangghost.

Lets a background session hand you a finished worktree branch, and fast-forwards it when you press the pane's run button.

Draws

Install

The marketplace name is learning-hacker-claude-mod.

In Claude Code
/plugin marketplace add Hangghost/learning-hacker-claude-mod
/plugin install handoff-runner@learning-hacker-claude-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.1.0
License
MIT
Repo stars
13
Last change
2026-10-04

What it can reach

  • Draws in the session
  • Reaches the network or an outside service
  • Sees tool calls
  • Runs a command when you press
  • Calls another program on this machine

The pane's labels are in Traditional Chinese. Needs Claude Code 2.1.287 or later. /handoff opens the pane. A background session can issue a ticket with a branch, a target (main if you leave it out), and the commit pinned at that moment. The ticket carries no command and no path. The git steps are derived when the pane checks, shown in full, and limited to a fast-forward merge, an update of the ref with the expected old value, and, only if you turn push on, a push that is not a force push. Push is off by default, and that push is the only network call. The only way to run those steps is the run button in the pane. On that press the steps are derived again and must match the pane, then checked after. The model can issue a ticket and cannot land the branch. Tickets live under the repository's git common directory in handoffs/, shared by every worktree and never committed. The button is there in the terminal and in the desktop app's Code tab. claude -p can issue a ticket and has no pane.

The install name is handoff-runner. This page adds the author's name. learning-hacker-claude-mod is a collection of Claude Code mods by Learning Hacker, shared as-is, without support. The marketplace name is learning-hacker-claude-mod. The marketplace also holds dispatch-board, dispatch-relay, and working-memory. This one installs on its own. The marketplace source is ./plugins/handoff-runner. The button that lands the branch is why this page files it under workflow. project-pane-szotasz draws a side pane of this repo's git, pull requests, CI, deploys, and Supabase, and fast-forwards the branch when you press Sync. gh-status-oborchers draws the branch's pull request, issues, and Actions above the prompt, and a confirmed press sends a merge or a review to GitHub. This one lands a branch another worktree finished, from a ticket you approve.

Demo

The English section of the handoff-runner README: a ticket from a background session, a fast-forward with one press in the /handoff pane, the checks before and after, and push off by default.
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • tool.callAround a tool call, where it can hold onemcp__handoff-runner__handoff_issue
  • command.runWhen you run its slash command/handoff
  • ui.closeWhen its pane closes
  • ui.renderDraws into the sessionAbovePromptPane

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

Slash commands 1

  • /handoff交接單面板:檢查、執行、撤單

Files

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

Facts

Author
Hangghost
Category
Workflow
Marketplace
learning-hacker-claude-mod
Repo
Hangghost/learning-hacker-claude-mod
Folder
plugins/handoff-runner
Version
0.1.0
License
MIT
Repo stars
13
Last change
2026-10-04
Language
TypeScript
Files
12

Other mods in Workflow

qa-guideaieo-productWhen Claude asks a question, opens a pane that explains why, what each option does, and which option it would pick.workflow-watchalonbaronFollows the session's newest Workflow run and draws each stage live in a pane, a band above the prompt, and the status line.aicqashfulcraDraws AICQ, Fulcra's agent-to-agent work: your agents, friends' agents, and the collaborations under way, and answers new messages in the mode you set.gh-accountVedantAndhaleRuns each git or gh step as the logged-in GitHub account that owns that repository or is in its organization, and counts them on the status line.lightningLightning-AIDraws a live progress bar above the prompt for each Lightning AI job, with skills for that cloud platform's GPU studios, batch jobs, and deployments.ccfnaniilujaKeeps planning in plan mode, checks work against the project spec, runs slices in parallel, and can draw the task, the board, and the waves.roadraven-hudShuffzordDraws a live pane of RoadRaven, a local desktop plan tree, with agents on each node, UAT you pass or fail, and a backlog you can start.bettercallgptinsta-fusionPuts this session on a voice call you talk on while Claude codes, and sends microphone audio and call text to Azure or OpenAI on your own key.allowlist-coachice-lfernandesCounts permission dialogs you answer and, after repeated approvals, offers that rule for the allow list, asking you before it writes.test-hudice-lfernandesDraws each test run on the status line, passing over total with a sparkline of failures, and a pane of the tests that failed.run-lot-panepierrebelinFor cctoolkit, which builds a feature batch by batch, draws a live pane of the batch or the plan, with agents, tools, and tokens.html-shelfronanworksDraws paths in a reply as links that open in the default app, and code blocks as cards you can copy or place in the prompt.
All 396 in Workflow