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.
/plugin marketplace add obie/auto-handoff /plugin install auto-handoff@auto-handoff
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

What it hooks into
session.startWhen a session startsprompt.submitWhen you send a promptcommand.runWhen you run its slash commandturn.startWhen Claude starts a turnturn.completeWhen a turn endssession.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
- Version
- 0.1.0
- License
- MIT
- Repo stars
- 103
- Last change
- 2026-10-20
- Language
- TypeScript
- Files
- 10