ClaudeMods
☰
ZH-TW
● — 人在線上 · 瀏覽 — 次
贊助提交作品
GitHub 儲存庫 · 發布者 halluton

mindful-claude

在等待生成時表現出呼吸節奏,鼓勵短暫的休息。

已翻譯

關於這個 mod

在等待生成時表現出呼吸節奏,鼓勵短暫的休息。

該專案由社區作者維護。有關功能、版本要求和配置,請參閱下面的原始自述文件。本站提供權限掃描結果;安裝前檢查來源和外部相依性。

安裝

請先查看作者 README,確認 marketplace 與外掛名稱;指令可能隨儲存庫結構而變動。

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

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

| 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 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.

取得徽章

這是你的專案嗎?把這個徽章放進 README 或網站,連回本頁。

Featured on ClaudeMods
尺寸
配色
Markdown
HTML

更多類似作品