Mindful Claude：Claude の作業中に深呼吸できる Claude Code の呼吸 Mod

Mindful Claude は Claude Code の呼吸 Mod で、Anthony（halluton）によるコミュニティ Mod です。Claude を待つ時間を、短いガイド付きの呼吸エクササイズに変えてくれます。Claude が作業を始めると、入力欄の上に 9 行の呼吸アニメーションが現れ、その下に Breathe in... 4s のようなフェーズの行とエクササイズ名が表示されます。同時にスピナーの文言も呼吸に合わせて変わり、いつもの文言の代わりに Breathe in 4s… と表示されます。Claude が応答すると、帯は消えます。

README にある作者の考えはこうです。1 分あたり約 5.5 回のゆっくりした呼吸は心拍変動を高めるので、ターミナルを離れることなく、Claude のターンのたびに小さな呼吸セッションができる、というものです。エクササイズは 4 種類（Coherent Breathing、Physiological Sigh、Box Breathing、4-7-8 Breathing）、アニメーションのスタイルも 4 種類（pulse、ripples、dots、wave）あります。デフォルトではスタイルはターンごとにランダムに選ばれ、同じものが 2 回続くことはありません。/breathe スラッシュコマンドで設定を変更でき、設定はセッションをまたいで保持されます。README によると、Claude Code 2.1.269 以降が必要です。

録画では、この Mod を読み込んだ Claude Code を起動し、Claude に 3 つのファイルを読んでプロジェクトを説明するよう依頼します。ターンの実行中、プロンプトの上の呼吸の帯が Breathe in… 5s のラベル（デフォルトの Coherent Breathing のパターン）とともに広がったり縮んだりし、スピナーの行も同じリズムで変化します。

インストールブロックのいずれかの方法を使ってください。どれも作者自身のマーケットプレイスから直接インストールします。インストール後に何かプロンプトを送れば、Claude の作業中に帯が表示されます。

Mod は 2 つの部分からなります。hooks/register.tsx はフックモジュールで、ターンの開始時刻を記録し、AbovePrompt の描画位置にフックします。エンジンがターンの作業中を報告すると、クライアントサーフェスモジュール hooks/breathe.tsx をマウントし、これが独自のクロックで 1 秒に 10 回アニメーションを描画します。以下は hooks/register.tsx の描画フックです。

on('ui.render', { component: 'AbovePrompt' }, async ($, e, next) => {
  if (e.surface !== 'terminal' || !config.enabled || !e.props.isWorking || e.props.hasSurvey) return next(e)
  const now = await $.clock.now()
  const running = turn ?? (turn = { startedAt: now, style: pickStyle(config.style, lastStyle) })
  const elapsedMs = now - running.startedAt
  if (elapsedMs < config.delay * 1000) return next(e)
  const { Box, Client } = $.ui.resolve(e)
  // ...
  return (
    <Box flexDirection="column">
      <Client key={key} module="./breathe.tsx" width={e.viewport?.columns ?? 80} height={rows}
        props={{ exercise: config.exercise, style: running.style, elapsedMs }} />
      {await next(e)}
    </Box>
  )
})

帯はターンの開始時刻をキーにしているので、ターンごとに新しいアニメーションになります。フェーズの行が変わるたびに、サーフェスは surface.post で現在の文言を送り返します。フックモジュールはそれを ui.message フックで受け取り、Spinner コンポーネントに対する 2 つ目の描画フックに渡して、スピナーの message プロパティを置き換えます。turn.complete フックがターンをクリアするので、Claude が応答するとすぐに帯は消えます。エクササイズ、イージング曲線、形状は hooks/breath/ に純粋関数として置かれています。

すべての設定は、Mod が session.start で登録する /breathe コマンドで行います。

• /breathe は現在の設定を表示し、/breathe help はすべてのオプションを一覧表示します。
• /breathe on / off で帯を表示・非表示にします。
• /breathe hrv、sigh、box、478 でエクササイズを選びます。
• /breathe style wave でスタイルをひとつに固定し（pulse、ripples、dots、wave）、/breathe style random でデフォルトに戻します。
• /breathe delay 5 にすると、ターン開始から 5 秒待ってから帯を表示するので、すぐ終わる応答では静かなままです。
• /breathe spinner off でスピナーのテキストには手を付けなくなります。

設定は $.store のひとつの config キーに保存され、次のセッション開始時に読み込まれます。

私たちは実行前に、プラグインが読み込むすべてのファイルを読みました。プラグインが使うのは UI、クロック、コマンド、ストアの呼び出しだけで、$.process.run、ネットワーク、ファイルアクセスはありません。あなたのコード、プロンプト、トランスクリプトは読みません。設定は Mod 専用の $.store に保存され、settings.json やシェルの rc ファイルを編集することはありません。UI の変更 は帯と書き換えられたスピナーの文言、コマンド・ツールの追加 は /breathe、データの保存 は保存された設定に対応します。

リポジトリには、元の bash と tmux 版が入った legacy/ フォルダーもあります。プラグインはこれを読み込みません。その install.sh は ~/.claude/settings.json を編集し ~/.claude/mindful/ に書き込むので、旧バージョンを使いたい場合にだけ実行してください。claude plugin validate は警告をひとつ報告します。プラグイン名に "claude" が含まれており、Anthropic のプラグインのように読めるという指摘です。これは命名に関する注意で、コードの問題ではありません。

macOS 上の Claude Code 2.1.291 で検証し、作者の 31 件の bun test 単体テストはすべて成功しました。テストは bun:test をインポートしているため、claude plugin test では読み込めません。帯が表示されない場合は、次を確認してください。

• claude --version が 2.1.269 以降であること。作者の README では、~/.claude/settings.json の env ブロックに CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 を設定するよう求めています。
• /breathe を実行し、breathe: on と delay 0s になっていること。
• 帯はターミナルでのみ描画されます。また、プロンプトの上にアンケートが開いている間はその場を譲ります。
• すでに開いているセッションにインストールした後は、/reload-plugins を実行してください。