_                    ___ _   _
| |__  _ __ ___      / _ (_) | |_  | |__
| '_ \| '__/ _ \    / /_\/ | | __| | '_ \
| |_) | | |  __/   / /_\\| | | |_  | | | |
|_.__/|_|  \___|   \____/|_|  \__| |_| |_|

Meditation for Vibe Coders

Breathe while Claude builds. Gong when it's time to code again.

How it Works · Techniques · Hooks · Website

---

What

breAIth — a CLI meditation companion for developers using Claude Code.

Two modes:

• Claude building → 3D wireframe geometry breathes with you. Guided breathing. Timer.
• Claude idle / needs you → Tamagotchi companion waits. Alerts when action needed.

Meditation starts automatically when Claude starts working. Ends with a gong when Claude finishes or needs your input. Zero deps. Pure Python.

Install

# One-liner
curl -fsSL https://raw.githubusercontent.com/exhuman777/breathe/main/breathe.py -o ~/.local/bin/breathe && chmod +x ~/.local/bin/breathe

# Clone
git clone https://github.com/exhuman777/breathe.git
cd breathe && python3 breathe.py

How it Works

You give Claude a task
        ↓
Claude starts building (high CPU)
        ↓
   breAIth activates → 3D geometry + guided breathing
        ↓
Claude finishes / needs input / permission
        ↓
   GONG → tamagotchi alert → "ACTION NEEDED"
        ↓
You switch back to code

When Claude is idle, a small ASCII companion waits for you. It blinks, looks around, shows rotating messages. Tech-romantic digital pet energy.

Techniques

Key	Technique	Pattern	Purpose
box	Box	4-4-4-4	Stress control
relax	4-7-8	4-7-8	Deep relaxation
focus	Focus	4-4-6-2	Clarity
energy	Energy	20x fast + 15s hold	Activation

Press t to cycle techniques during a session. Each maps to a unique 3D wireframe shape.

Claude Code Hooks

Auto-launch breAIth when Claude works. Auto-end when done.

python3 breathe.py --install-hooks --confirm

Three hooks:

• PreToolUse (Bash/Edit/Write) → launches in new Terminal (atomic lock, only one window ever)
• Stop → signals end (Claude finished)
• Notification (permission_prompt) → signals end (Claude needs input)

Controls

Key	Action
t	Cycle breathing technique
s	Toggle sound on/off
q / ESC	Quit

Sound

• Gong (Glass.aiff x3) → session end
• Alert (Funk.aiff) → action needed
• Tick (Tink.aiff) → breath phase transitions
• --silent flag or s key to mute

Requirements

• Python 3.6+
• macOS (Terminal.app hooks + system sounds)
• Terminal with Unicode + 256 colors

---

_{Built by exhuman. Breathe between the builds.}