Mindful Claude: Die Claude Code Atem-Mod für die Wartezeit

Mindful Claude ist eine Community-Mod von Anthony (halluton). Die Claude Code Atem-Mod verwandelt die Zeit, in der du auf Claude wartest, in eine kurze geführte Atemübung. Wenn Claude zu arbeiten beginnt, erscheint über dem Eingabefeld eine neunzeilige Atemanimation, darunter eine Phasenzeile wie Breathe in... 4s und der Name der Übung. Gleichzeitig wechselt das Spinner-Wort zum Atem, sodass dort Breathe in 4s… statt des üblichen Textes steht. Wenn Claude antwortet, verschwindet das Band.

Die Begründung des Autors aus dem README: Langsames Atmen mit etwa 5,5 Atemzügen pro Minute erhöht die Herzratenvariabilität, sodass jeder Claude-Turn zu einer kleinen Atemsitzung wird, ohne das Terminal zu verlassen. Es gibt vier Übungen (Kohärentes Atmen, physiologischer Seufzer, Box Breathing und 4-7-8-Atmung) und vier Animationsstile (pulse, ripples, dots und wave). Standardmäßig wird der Stil für jeden Turn zufällig gewählt, nie zweimal hintereinander derselbe. Ein Slash-Befehl /breathe ändert die Einstellungen, und sie bleiben über Sitzungen hinweg erhalten. Laut README ist Claude Code 2.1.269 oder neuer nötig.

Die Aufnahme startet Claude Code mit geladener Mod und bittet Claude, drei Dateien zu lesen und das Projekt zu beschreiben. Während der Turn läuft, dehnt sich das Atemband über dem Prompt mit der Beschriftung Breathe in… 5s (das Standardmuster Kohärentes Atmen) aus und zieht sich zusammen, und die Spinner-Zeile folgt demselben Rhythmus.

Nutze eine beliebige Methode aus dem Installationsblock; alle installieren direkt aus dem eigenen Marketplace des Autors. Sende nach der Installation einen beliebigen Prompt, und das Band erscheint, während Claude arbeitet.

Die Mod besteht aus zwei Teilen. hooks/register.tsx ist das Hook-Modul: Es merkt sich, wann der Turn begonnen hat, und hängt sich an die Render-Stelle AbovePrompt. Wenn die Engine meldet, dass ein Turn arbeitet, bindet es ein Client-Surface-Modul ein, hooks/breathe.tsx, das die Animation mit eigener Uhr zehnmal pro Sekunde zeichnet. Hier der Render-Hook aus 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>
  )
})

Das Band nutzt die Startzeit des Turns als Key, sodass jeder Turn eine frische Animation bekommt. Immer wenn sich die Phasenzeile ändert, schickt die Surface das aktuelle Wort mit surface.post zurück. Das Hook-Modul empfängt es in einem ui.message-Hook und gibt es an einen zweiten Render-Hook auf der Komponente Spinner weiter, der die Prop message des Spinners ersetzt. Der Hook turn.complete löscht den Turn, sodass das Band verschwindet, sobald Claude antwortet. Die Übungen, die Easing-Kurve und die Formen liegen als reine Funktionen in hooks/breath/.

Alles wird mit dem Befehl /breathe eingestellt, den die Mod bei session.start registriert:

• /breathe zeigt die aktuellen Einstellungen, /breathe help listet alle Optionen.
• /breathe on / off blendet das Band ein oder aus.
• /breathe hrv, sigh, box oder 478 wählt die Übung.
• /breathe style wave legt einen Stil fest (pulse, ripples, dots, wave), und /breathe style random kehrt zum Standard zurück.
• /breathe delay 5 wartet fünf Sekunden nach Beginn eines Turns, bevor das Band erscheint, damit kurze Antworten ruhig bleiben.
• /breathe spinner off lässt den Spinner-Text in Ruhe.

Die Einstellungen werden mit $.store unter einem einzigen Schlüssel config gespeichert und beim nächsten Sitzungsstart wieder gelesen.

Wir haben jede Datei gelesen, die das Plugin lädt, bevor wir es ausgeführt haben. Das Plugin nutzt nur UI-, Uhr-, Befehls- und Speicheraufrufe: kein $.process.run, kein Netzwerk, kein Dateizugriff. Es liest weder deinen Code noch deine Prompts oder das Transkript. Seine Einstellungen liegen im eigenen $.store der Mod, und es bearbeitet nie settings.json oder Shell-rc-Dateien. Ändert die UI betrifft das Band und das umgeschriebene Spinner-Wort; Fügt Befehle/Tools hinzu betrifft /breathe, und Speichert Daten betrifft die gespeicherten Einstellungen.

Das Repository enthält außerdem einen Ordner legacy/ mit der ursprünglichen Bash- und tmux-Version. Das Plugin lädt ihn nicht. Dessen install.sh bearbeitet ~/.claude/settings.json und schreibt nach ~/.claude/mindful/, führe es also nur aus, wenn du die alte Version willst. claude plugin validate meldet eine Warnung: Der Plugin-Name enthält „claude“, was laut Validator wie ein Anthropic-Plugin klingt. Das ist ein Hinweis zur Benennung, kein Problem mit dem Code.

Wir haben die Mod mit Claude Code 2.1.291 unter macOS validiert, und die 31 bun test-Unit-Tests des Autors laufen durch. claude plugin test kann sie nicht laden, weil sie bun:test importieren. Wenn das Band nicht erscheint:

• Prüfe, ob claude --version 2.1.269 oder neuer ist. Das README des Autors verlangt außerdem, CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 im env-Block von ~/.claude/settings.json zu setzen.
• Führe /breathe aus und prüfe, ob dort breathe: on und delay 0s steht.
• Das Band wird nur im Terminal gezeichnet. Es tritt auch zur Seite, solange über dem Prompt eine Umfrage geöffnet ist.
• Führe nach einer Installation in eine bereits offene Sitzung /reload-plugins aus.