mindful-claude

Reviewed at commit 411c9c4

A guided breathing band above the prompt while a turn runs; the spinner counts the breath with you.

Made by
Anthony
What we checked

Draws an animated breathing guide above the prompt while Claude is working and shows the current breath phase in the spinner line. /breathe switches it on or off and picks the exercise, style and delay. It reads no prompts, files or tool calls, makes no network calls, and only stores those settings.

Review details

Static review of the source at the pinned commit; not run. Registers session.start (loads saved settings from $.store and registers /breathe), command.run for /breathe (updates and stores the config), turn.start and turn.complete (timing only, trigger re-render), ui.message (receives the phase text from its own band) and ui.render for the AbovePrompt and Spinner components (mounts the breathe.tsx surface module and replaces the spinner word with the phase). Uses $.store, $.command.register, $.clock, $.ui.invalidate/resolve/log. The surface module breathe.tsx runs a local 100 ms timer and draws text from pure functions in breath/shapes.ts and breath/exercises.ts. No fs, http or process use, no eval; no files outside the plugin are touched.

What it uses
  • Reads your prompts: no
  • Sees tool calls: no
  • Blocks or changes tool calls: no
  • Reads or writes files: no
  • Runs programs on your machine: no
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: yes
  • Shows something on screen: yes
Hooked events

Guided breathing exercises above the prompt while Claude works: coherent, box, 4-7-8 and the physiological sigh, four animation styles, and the spinner reads the breath. Appears when Claude starts, disappears when Claude answers. Needs function hooks (early access) and an interactive terminal.

Made this mod? Add a badge to your README

modsforClaude badge for mindful-claude

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/mindful-claude.svg)](https://modsforclaude.com/mods/mindful-claude/)

← All mods