Vibe Index
🔌

mindful-claude

🔌Plugin🧩 Mod

A Claude Code add-on that turns waiting time into a short breathing exercise. While Claude works, a breathing animation guides you, and it disappears when the answer arrives.

halluton/Mindful-Claude110Added Nov 12, 2026

Installation

$/plugin marketplace add halluton/Mindful-Claude
$/plugin install mindful-claude@mindful-claude

Run these in Claude Code. In a session that is already open, run /reload-plugins after installing.

Permissions to check

Nothing to check.

Also: Interface · /commands · Own data · Session info

Raw check output (Claude Code 2.1.322)

hooks: session.start, command.run{command=breathe}, turn.start, turn.complete, ui.message, ui.render{component=AbovePrompt}, ui.render{component=Spinner}

calls: $.clock.after, $.clock.now, $.command.register, $.store.get, $.store.set, $.ui.invalidate, $.ui.log (via log), $.ui.resolve

mod

README.md

View on GitHub →

Mindful Claude

Breathe while Claude works.

Every prompt you send gives you 10 to 60+ seconds of waiting. This Claude Mod turns that time into a guided breathing exercise. When Claude starts working, a breathing animation appears above the prompt and the spinner counts the breath with you. When Claude answers, it's gone.

Mindful Claude demo

Why

Slow breathing at about 5.5 breaths per minute raises heart rate variability (HRV), a marker of stress resilience. Even short sessions lower cortisol and sharpen focus. Every Claude turn becomes a micro-session, and you never leave the terminal.

Install

Needs Claude Code 2.1.269 or later. Claude Mods are in early access, so turn them on in ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_ENABLE_FUNCTION_HOOKS": "1"
  }
}

Then:

claude plugin marketplace add halluton/Mindful-Claude
claude plugin install mindful-claude@mindful-claude

Start claude, send a prompt, breathe.

To remove it: claude plugin uninstall mindful-claude.

/breathe

CommandWhat it does
/breatheShow the current settings
/breathe off / onHide or show the band
/breathe hrvCoherent Breathing: 5.5s in, 5.5s out
/breathe sighPhysiological Sigh: double inhale, long exhale
/breathe boxBox Breathing: 4s in, 4s hold, 4s out, 4s hold
/breathe 4784-7-8 Breathing: 4s in, 7s hold, 8s out
/breathe style wavePin a style: pulse, ripples, dots, wave, or random
/breathe delay 5Seconds into a turn before the band appears (default 0)
/breathe spinner offLeave the spinner alone

Settings persist across sessions.

ExerciseBest for
Coherent BreathingSustained HRV improvement
Physiological SighQuick calm-down
Box BreathingFocus and concentration
4-7-8 BreathingDeep relaxation

How it works

A Claude Mod is a plugin whose hooks are TypeScript functions running inside Claude Code. This one costs zero tokens: the model never sees it.

  • hooks/register.tsx hooks ui.render for the band above the prompt and mounts the animation while the engine says a turn is working. It also rewrites the spinner's word with the current phase and registers /breathe.
  • hooks/breathe.tsx is the animation, drawn ten times a second on the surface's own clock.
  • hooks/breath/ holds the exercises, easing and shapes as pure functions, covered by bun test.

Develop

git clone https://github.com/halluton/Mindful-Claude
cd Mindful-Claude
claude --plugin-dir .      # loads from disk, hot-reloads on save
bun test

For type checking, run /plugin-types in that session, then bunx -p typescript tsc -p ..

The original bash and tmux version lives in legacy/.

License

MIT. See LICENSE.