keeping automatic track of changes using: handoff watch
smartly keep track of decisions made in a session
export the saved context and decisions, compress token limits as per need
Handoff
This tool is built to ease up and solve an issue I personally faced quite a bit, and I thought others like me would face it too: switching agents on a single project.
The main problem with switching would be keeping both agents in sync of each other, be it switching because hitting rate limits on one or you think one agent is better for UI/UX and the other for actually writing good code.
Following are the details and working of this tool (written with Claude):
How it works:
Instead of letting each agent re-read everything, Handoff maintains a single HANDOFF.md file — a compressed snapshot of your project state, recent changes, and decisions made.
Switch agents → point to
HANDOFF.md
→ full context in ~1k tokens instead of 50k+.
Features:
Background watcher
— auto-regenerates
HANDOFF.md
as you work. Always fresh, always lean. (video 1)
Decision extraction
— captures “why” decisions from your sessions. New agent knows you chose AWS over Azure, which auth pattern you’re using, etc. (video 2)
Smart compression
— set a token budget and it prioritizes what matters. handoff export --compress --token-budget 1000 (video 3)
Install:
npm i handoff-cli
Works with Claude Code, OpenAI Codex, Cursor, Windsurf, or any CLI-based agent.
Feedback is welcomed. What would make this more useful for your workflow?
submitted by
/u/Hot_Dog1982
Originally posted by u/Hot_Dog1982 on r/ClaudeCode