What this mod can do
- Reviewed at commit 7d29773
- Writes files
- Sends its own requests to Claude, which uses your tokens
- Sends the conversation to Claude with its own requests, which uses your tokens
- Submits prompts for you, which can be sent as your own words
- Sees the context sent with your first message, such as CLAUDE.md, and can change it
- Reads environment variables
- Sees each change to /config and can block or rewrite it
- Sees each prompt you send and can change or drop it
- Runs slash commands
- Sees each tool call before it runs and can block or change it
8 more things it can do
- Reads files
- Reads your settings
- Reads the conversation
- Remembers data between sessions
- Adds slash commands
- Lists running subagents
- Runs on a timer
- Runs on Claude Code hooks, such as session start
Good to know (3)
- On an API key, Bedrock or Vertex the cache lasts only 5 minutes, so run /handoff refresh off.
- Handing off at 600k tokens is off by default; turn on auto_handoff in the panel's Settings tab.
- Guards that remind or block tool calls only apply after you say yes.
Preview
Terminal
⎿ ctx-handoff: Panel opened above the input. Click the buttons, or press ctrl+x tab to use the
keyboard. Run /handoff panel again to close it
╭─────────────────────────────────────────────────────────────────────────────────────────────╮ [-]
│ ctx-handoff · Project notes and guards [ Close ] │
│ Away work enabled; next 11/1/2026, 4:49:40 PM [ Pause away work for this session ] │
│ No background usage collected for this session yet; earlier cost is not known to be zero │
│ │
│ [ Guards 0 ][ Memory 0 ][ Rules 0 ][ Last update ][ Settings ] │
│ │
│ No guards yet. Once a rule appears 3+ times you can ask the model to draft one. │
↓ 3 more
⚠ ctx-handoff: 29 more messages until notes updateClaude Desktop
What it does
In the author's words
Turns what you teach Claude into project notes, catches its usual slips, keeps the cache warm while you're away, and picks long sessions back up
- What you see
- A panel above the prompt from /handoff panel
- Works in
- Terminal and Claude Desktop
- Slash commands
- /handoff, /ctx-handoff
- Uses your tokens
- Notes updates, idle cache refreshes, handoff summaries
- Changes files
- Notes in ~/.claude/projects/ and lines in your repo
- Network access
- None
- Reviewed commit
- 7d29773
- Preview recorded with
- Claude Code 2.1.309
How it works
- Sends only the new part of the conversation to Sonnet 5.5 to update a project notes file
- After about 50 idle minutes, sends a tiny request to keep the cache warm, up to 3 times
- Then saves a handoff summary, so /handoff resume can start fresh from it
- Nudges Claude when it retries a failing command or says done without testing
Common questions
Why does Claude Code reread everything after I step away?
The conversation cache expires while you're idle, so your next message rereads it all at full price. ctx-handoff sends a small request after about 50 idle minutes to keep it warm, up to 3 times (about 3.5 hours).
How do I continue a Claude Code session after /clear?
After /clear or reopening Claude Code, ctx-handoff tells the new conversation the last task, its state and the next step. If it saved a summary while you were away, /handoff resume starts fresh from it.
How do I make Claude Code remember my preferences?
Claude Code loads CLAUDE.md memory files at startup. ctx-handoff turns preferences, corrections and facts you give into a Markdown notes file per project, loaded into every new conversation, and an instruction you repeat 3 times becomes a line in your repo.
What does ctx-handoff cost to run?
It runs on your Claude Code sign-in. A handoff is one request, a cache refresh reads from cache at about a tenth of the input price, and a notes update sends only the new part of the conversation. Nudges cost nothing.
Badge for your README
Own this listing? Add it to your README. The badge shows the install count as it grows.
[](https://staging.statuslin.es/mods/ctx-handoff?utm_source=readme-badge)
Or show the preview card:
[](https://staging.statuslin.es/mods/ctx-handoff?utm_source=readme-badge)