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.1
Repo stars
4
Last change
2026-10-15
What it can reach
Draws in the session
Sees tool calls
Reminders come at 5, 10, 30, 60 and 120 minutes of run time and every two hours after; the marks option sets when they come and the every option how often they go on, set with claude plugin configure caffeine@alfreds-plugins. A reminder reaches a running turn as a row the model reads at its next step, so a session waiting on a long command gets it when that command returns. Tracking ends with the task's completion notification or a TaskStop of it. Where an organization manages Claude Code, the subagent hold needs the organization to list caffeine in its managed settings. To load it from a checkout for one session, start claude with --plugin-dir plugins/caffeine.
The marketplace, alfreds-plugins, also holds smart-compact and crew, each installed on its own. Keeping the agent aware of work it started is why this page files it under workflow. peek-vedantandhale opens a pane of background shells and subagents, with elapsed time and their last output lines. tqdm-claude draws tqdm-style progress bars above the prompt for background tasks and subagents, read from each task's output, and flags crashes, stalls, and quiet failures. This one draws little: a toast, when a reminder is due while the session is idle and wakes it with the reminder as a prompt. The reminder names the task and its command, how long it has run, when its output last changed and the output's last lines, and asks whether it is still needed, with TaskStop as the way out. A foreground subagent that is about to end its turn while a command the engine would kill with it still runs is stopped once, with a reason that lists the commands. In the source, that is a SubagentStop block, not a denied command, so this page does not file it as a hold.
Demo
Screenshot of the author's GitHub page.
What it hooks into
session.startWhen a session starts
turn.stepAt each step of a turn
tool.callAround a tool call, where it can hold oneBashTaskStop
prompt.submitWhen you send a prompt
classic.SubagentStopA Claude Code event
turn.completeWhen a turn 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.