Mindful Claude
Guided breathing above the prompt while Claude works.
Illustration. Actual results depend on the mod, terminal and environment.
Install
/plugin marketplace add halluton/Mindful-Claude
/plugin install mindful-claude@mindful-claude
/reload-pluginsRun these commands one at a time in a Claude Code session.
claude plugin marketplace add halluton/Mindful-Claude
claude plugin install mindful-claude@mindful-claudeThen run /reload-plugins in your session, or start a new session.
Please install the Claude Code mod "Mindful Claude" (https://github.com/halluton/Mindful-Claude). Before installing, read the Security and Requirements sections of its README and tell me what it reads and writes, which commands it runs, whether it uses the network, and which Claude Code version, OS and terminal it needs. If everything looks fine, run claude plugin marketplace add halluton/Mindful-Claude and claude plugin install mindful-claude@mindful-claude, then remind me to run /reload-plugins in my session.Send this to Claude Code so it reads the author’s instructions before installing.
git clone https://github.com/halluton/Mindful-Claude
cd Mindful-Claude
claude --plugin-dir .Clone the repository and try it in a local session with --plugin-dir.
What it accesses
Based on the author’s documentation, checked when listed; use claude plugin validate to check for yourself.
Reads
YesReads the engine work phase to run the breathing animation and rewrite the spinner word.
Writes files
YesSettings persist across sessions.
Runs commands
NoneNetwork
NoneIntroduction
Mindful Claude is a wait-time function-hooks mod: when Claude works it draws a breathing animation above the prompt and the spinner tracks the breath; it clears when Claude answers. Supports coherent, box, 4-7-8 and physiological sigh patterns via /breathe. README targets 2.1.269+ with the early hooks flag. Not run-tested. Preview is illustrative.
Who it is for
- People who want a short breathing practice while Claude works
Requirements
- Claude Code ≥ 2.1.269
- README still documents early-access and CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1.
- Needs an interactive terminal.