Mindful-Claude
Breathe while Claude works.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/halluton--mindful-claude)HTML
<a href="/listings/halluton--mindful-claude"><img src="/api/listings/halluton--mindful-claude/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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`.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 15 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "mindful-claude",
- "owner": { "name": "Anthony" },
- "metadata": { "description": "mindful-claude: breathe while Claude works" },
- "plugins": [
- {
- "name": "mindful-claude",
- "source": "./",
- "description": "Guided breathing exercises above the Claude Code prompt while Claude works; the spinner reads the breath",
- "homepage": "https://github.com/halluton/Mindful-Claude",
- "repository": "https://github.com/halluton/Mindful-Claude",
- "license": "MIT"
- }
- ]
- }
README.md · README · 82 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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.
- 
- ## 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`:
- ```json
- {
- "env": {
- "CLAUDE_CODE_ENABLE_FUNCTION_HOOKS": "1"
- }
- }
- ```
- Then:
- ```sh
- 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`
- | Command | What it does |
- |---|---|
- | `/breathe` | Show the current settings |
- | `/breathe off` / `on` | Hide or show the band |
- | `/breathe hrv` | Coherent Breathing: 5.5s in, 5.5s out |
- | `/breathe sigh` | Physiological Sigh: double inhale, long exhale |
- | `/breathe box` | Box Breathing: 4s in, 4s hold, 4s out, 4s hold |
- | `/breathe 478` | 4-7-8 Breathing: 4s in, 7s hold, 8s out |
- | `/breathe style wave` | Pin a style: `pulse`, `ripples`, `dots`, `wave`, or `random` |
- | `/breathe delay 5` | Seconds into a turn before the band appears (default 0) |
- | `/breathe spinner off` | Leave the spinner alone |
- Settings persist across sessions.
- | Exercise | Best for |
- |---|---|
- | **Coherent Breathing** | Sustained HRV improvement |
- | **Physiological Sigh** | Quick calm-down |
- | **Box Breathing** | Focus and concentration |
- | **4-7-8 Breathing** | Deep relaxation |
- ## How it works
- A [Claude Mod](https://github.com/anthropics/claude-code/issues/91870) 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
- ```sh
- 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/`](legacy/).
- ## License
- MIT. See [LICENSE](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.