Claude Code mod sweet-spot

At the end of an answer it looks at the context size. Past the threshold, and when nothing else is going on, a line above the prompt counts down countdown_seconds (10 by default). Key 1 in an empty prompt moves the handover back; typing or sending a message stops the countdown without moving anything, and the next pause counts down again.

/sweet-spot status shows the context against the window, where the next handover comes and the emergency brake. /sweet-spot later 50k moves one handover back by 50k tokens, /sweet-spot asap hands over at the next pause wherever the context stands, and /sweet-spot redeliver submits a held message again if delivering it failed.

handoff_method picks the way and handoff_fallback the one tried when it fails before it changed the session. internal-handoff (the default) writes a handoff with a built-in prompt, which ~/.claude/sweet-spot/handoff-prompt.md replaces. builtin-compact is Claude Code's own /compact, and the session stays. external-command runs a handoff command of your own and reads its file.

Measured in real handovers, a fresh session starts at 62k to 98k tokens. A threshold below 130000 is refused with the reason, and the mod stays off.

ui.render draws the countdown above the prompt and command.run answers /sweet-spot. The other events tell it when a turn starts, steps and completes, what is typed and submitted, which tools run, and when a session starts, ends or is compacted: turn.start, turn.step, turn.complete, prompt.edit, prompt.submit, tool.call, session.start, session.end and session.compact. It also registers the classic events Stop, UserPromptSubmit, SessionStart, PermissionRequest and PostModelSwitch.

It reads the session transcript to learn how long its prompt cache lives, the handoff file, the optional handoff prompt, a listing of the temp directory to find a handoff, and the environment variables HOME and TMPDIR. To check this against the code, run claude plugin validate . in the repository: it lists every call the hooks make and every environment variable they read.

Inside Claude Code, add the marketplace and install the mod, then run /reload-plugins. The settings are in the /config menu under sweet-spot. To watch first, turn dry_run on: then it only says when it would hand over.

Clone the repository and load it as a plugin folder. To run its tests, run claude plugin test . in that folder.