ClaudeCodeMod

All shelves / Mods / Workflow

auto-handoff

By obie

auto-handoff is a Claude Code workflow mod by obie.

Writes a handoff file after the session sits idle, runs that handoff as if you typed it, and toasts when it does.

Draws

Install

The marketplace name is auto-handoff.

In Claude Code
/plugin marketplace add obie/auto-handoff
/plugin install auto-handoff@auto-handoff
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
103
Last change
2026-10-20

What it can reach

  • Draws in the session
  • Calls another program on this machine

Tested on Claude Code 2.1.289. The author says it is built on the function hooks API, which is early access and may change between releases. It loads at the next session start. The idle clock starts when a turn of the main conversation ends, and any new turn restarts it; a subagent finishing leaves it alone. After minutes of idle, 50 by default, it runs command as if you had typed it, by default /auto-handoff:handoff, and toasts. You get one handoff per absence, and /clear cancels a pending one. A laptop that slept through the wait wakes with a cold cache, so the handoff is skipped. The bundled skill writes docs/handoffs/<timestamp>-<slug>.md, with the goal, status, decisions, dead ends, files, verification commands, next steps, and open questions. The author says that to do that it runs date and git status, then writes that one file, and nothing gets committed; the skill pre-approves those tools for itself. Set minutes and command with /plugin configure auto-handoff. A command of your own needs allowed-tools for what it calls, or it waits at a permission prompt until you return. The default of 50 assumes the one-hour cache, and a session on the five-minute cache needs a much smaller minutes. The timer stops when you quit Claude Code.

The repository is its own marketplace, auto-handoff. Writing down where the work stands before the prompt cache goes cold is why this page files it under workflow. cache-clock-ray-amjad draws the time until the prompt cache goes cold, and has Claude write a handoff note at the warning. compact-keeper, by arasovic, saves a handoff file at each compaction, with the token counts, your /compact instructions, and the files edited. This one draws nothing but a toast: after a set idle time it runs a handoff command for you, once per absence.

Demo

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

What it hooks into

  • session.startWhen a session starts
  • prompt.submitWhen you send a prompt
  • command.runWhen you run its slash command
  • turn.startWhen Claude starts a turn
  • turn.completeWhen a turn ends
  • session.endWhen a session 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
obie
Category
Workflow
Marketplace
auto-handoff
Repo
obie/auto-handoff
Version
0.1.0
License
MIT
Repo stars
103
Last change
2026-10-20
Language
TypeScript
Files
10

Other mods in Workflow

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.shared-sessionParadigm-StudyHolds a commandDraws a Share control above the prompt so a teammate can join the session from their own Claude Code and see each turn as it happens.transcripted-liver3dbarsHolds a commandDraws the meeting Transcripted is recording above the prompt, with notes, a question aimed at you, and a wrap-up when the call ends.speckit-companionalfredoperezDraws a band above the prompt for the Spec Kit run you are following, and a pane of its steps, times, documents, and tasks.xcode-modsartemnovichkovDraws an Xcode band above the prompt and a pane for build, run, and tests, plus a canvas of SwiftUI preview snapshots.seo-cockpitAgriciDanielHolds a commandDraws a live audit band and a cockpit of Search Console, rankings, and Core Web Vitals, and holds a paid SEO API call that would pass the day's cap.
All 396 in Workflow