Skip to content
Back to search

Mindful-Claude

SkillWorks with Claude CodeGitHub

Breathe while Claude works.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/halluton--mindful-claude/badge.svg)](/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

i

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)

  1. {
  2. "name": "mindful-claude",
  3. "owner": { "name": "Anthony" },
  4. "metadata": { "description": "mindful-claude: breathe while Claude works" },
  5. "plugins": [
  6. {
  7. "name": "mindful-claude",
  8. "source": "./",
  9. "description": "Guided breathing exercises above the Claude Code prompt while Claude works; the spinner reads the breath",
  10. "homepage": "https://github.com/halluton/Mindful-Claude",
  11. "repository": "https://github.com/halluton/Mindful-Claude",
  12. "license": "MIT"
  13. }
  14. ]
  15. }
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)

  1. # Mindful Claude
  2. Breathe while Claude works.
  3. 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.
  4. ![Mindful Claude demo](demo.gif)
  5. ## Why
  6. 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.
  7. ## Install
  8. Needs Claude Code 2.1.269 or later. Claude Mods are in early access, so turn them on in `~/.claude/settings.json`:
  9. ```json
  10. {
  11. "env": {
  12. "CLAUDE_CODE_ENABLE_FUNCTION_HOOKS": "1"
  13. }
  14. }
  15. ```
  16. Then:
  17. ```sh
  18. claude plugin marketplace add halluton/Mindful-Claude
  19. claude plugin install mindful-claude@mindful-claude
  20. ```
  21. Start `claude`, send a prompt, breathe.
  22. To remove it: `claude plugin uninstall mindful-claude`.
  23. ## `/breathe`
  24. | Command | What it does |
  25. |---|---|
  26. | `/breathe` | Show the current settings |
  27. | `/breathe off` / `on` | Hide or show the band |
  28. | `/breathe hrv` | Coherent Breathing: 5.5s in, 5.5s out |
  29. | `/breathe sigh` | Physiological Sigh: double inhale, long exhale |
  30. | `/breathe box` | Box Breathing: 4s in, 4s hold, 4s out, 4s hold |
  31. | `/breathe 478` | 4-7-8 Breathing: 4s in, 7s hold, 8s out |
  32. | `/breathe style wave` | Pin a style: `pulse`, `ripples`, `dots`, `wave`, or `random` |
  33. | `/breathe delay 5` | Seconds into a turn before the band appears (default 0) |
  34. | `/breathe spinner off` | Leave the spinner alone |
  35. Settings persist across sessions.
  36. | Exercise | Best for |
  37. |---|---|
  38. | **Coherent Breathing** | Sustained HRV improvement |
  39. | **Physiological Sigh** | Quick calm-down |
  40. | **Box Breathing** | Focus and concentration |
  41. | **4-7-8 Breathing** | Deep relaxation |
  42. ## How it works
  43. 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.
  44. - `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`.
  45. - `hooks/breathe.tsx` is the animation, drawn ten times a second on the surface's own clock.
  46. - `hooks/breath/` holds the exercises, easing and shapes as pure functions, covered by `bun test`.
  47. ## Develop
  48. ```sh
  49. git clone https://github.com/halluton/Mindful-Claude
  50. cd Mindful-Claude
  51. claude --plugin-dir . # loads from disk, hot-reloads on save
  52. bun test
  53. ```
  54. For type checking, run `/plugin-types` in that session, then `bunx -p typescript tsc -p .`.
  55. The original bash and tmux version lives in [`legacy/`](legacy/).
  56. ## License
  57. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.