ClaudeCodeMod

All shelves / Mods / Workflow

caffeine

By zienag

caffeine is a Claude Code workflow mod by zienag.

Reminds the agent of each shell it left running in the background, and toasts when a reminder wakes an idle session.

Draws

Install

The marketplace name is alfreds-plugins.

In your shell
claude plugin marketplace add zienag/alfreds-plugins
claude plugin install caffeine@alfreds-plugins
Open the repo

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

Two paragraphs of the Reminders of background shells section of the author's README: at 5, 10, 30, 60 and 120 minutes of run time and every two hours after, a reminder names the task and its command, how long it has run, when its output last changed and its last lines, and asks whether it is still needed, with TaskStop <id> as the way out; a reminder reaches a running turn as a row the model reads at its next step, and an idle session is woken with the reminder as a prompt, with a toast saying so.
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.

Facts

Author
zienag
Category
Workflow
Marketplace
alfreds-plugins
Repo
zienag/alfreds-plugins
Folder
plugins/caffeine
Version
0.1.1
Repo stars
4
Last change
2026-10-15
Language
TypeScript
Files
8

Other mods in Workflow

where-am-ihamzaferDraws four things above the prompt: the goal, what is happening now, what is waiting on you, and the next step.next-stepshamzaferAfter each turn, draws two or three likely next prompts. In an empty prompt, 1, 2, or 3 drafts one. 0 dismisses them.agent-radarhamzaferDraws one line above the prompt for each running subagent: time, tool count, and what it is doing.mission-controlhamzafer/mission opens a pane of the main agent, its subagents, every tool call, and the files they touch.agent-quick-menuagentic-workbenchPuts installed plugins' commands and settings, and Claude Code's own settings, in a pane beside the session, with a favorites line above the prompt.browser-laneshamzaferHolds a commandDraws whether this session has a Playwright browser and who holds it. A subagent that wants the browser waits until the one using it is done.glancehamzaferDraws one line above the prompt for what needs you: the next meeting, pull requests, Linear issues, and Slack DMs.session-saverhamzafer/park saves where you left off. The next time that session resumes, it draws the note.prayer-timeshamzaferDraws the current prayer and how long is left, the next prayer, and zawal, above the prompt. Computed on your computer. The author says nothing is sent out.tool-radarSingh-APDraws a pane of every tool call as it happens, with status, arguments, duration, and failures.git-pulseSingh-APDraws the branch, ahead and behind, and dirty files on the status line, and a heads-up when Claude commits.test-pulseSingh-APDraws pass or fail on the status line, toasts when the suite flips, and marks flakes.
All 396 in Workflow