marekkowalczyk

marekkowalczyk / breathe-cli

Public

Paced resonance breathing in your terminal

marekkowalczyk.github.iobreathe-cli biofeedback breathing cli health heart-failure
73
1
89% credibility
Found May 31, 2026 at 73 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

Breathe CLI is a free, single-file program for Mac computers that guides you through slow, paced breathing sessions designed to train your vagal nerve and improve heart health. It uses breathing patterns backed by clinical research on heart failure patients, showing you a visual bar and playing gentle sounds to keep your pace steady at about 6 breaths per minute. You can choose preset sessions that adjust automatically based on the time of day, or customize your own duration and breathing ratio. The app tracks your completed sessions, includes clear safety guidelines, and deliberately avoids risky breathing patterns like breath holds or rapid breathing. It runs entirely offline with no external connections, stores your session history locally, and works on the Python that already comes with your Mac.

How It Works

1
🔍 Discovering the breathing app

You hear about a simple tool that helps you practice slow breathing for heart health, shared by someone in a health forum or recommended by a friend.

2
📥 Getting the app on your computer

You download a single file and make it ready to run on your Mac — no extra programs needed, just your computer's built-in tools.

3
🚀 Starting your first session

You open your terminal and type a simple command to launch the app, which immediately shows you a calming visual guide with a breathing bar.

4
Choosing how long to breathe
🌅
Morning or afternoon

Try a balanced 10-minute session with equal breathing phases to start your day centered.

🌆
Evening wind-down

Choose a longer 15-minute session with a longer exhale to help your body relax before bed.

5
🫁 Following the breath guide

A moving bar fills and empties on screen while gentle sounds mark each inhale and exhale, keeping your pace steady at 6 breaths per minute.

6
💾 Seeing your progress

After each session, the app shows you how long you practiced and how many complete breath cycles you finished, then saves it to your records.

🌿 Building a daily breathing habit

Over time, regular practice helps your nervous system stay calm, your heart rate variability improve, and your overall sense of well-being grow.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 73 to 73 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is breathe-cli?

Breathe-cli is a terminal-based breathing trainer that guides you through resonance breathing at 6 breaths per minute. It's a single Python script that runs entirely in your terminal with no external dependencies, using visual bars and audio cues to pace inhale and exhale phases. The app enforces clinically-grounded safety constraints—no breath holds, no rapid patterns—making it suitable for daily vagal tone training.

Why is it gaining traction?

The hook here is the science backing. This isn't another wellness app with vague claims; it cites specific clinical trials (Bernardi, Vaschillo, Lehrer) and explains exactly why 6 bpm and exhale-weighted ratios matter for autonomic nervous system regulation. Developers interested in biofeedback or HRV training get a frictionless tool that works right from the command line. The time-of-day auto-select feature means you can just type `breathe` and get an appropriate preset without thinking.

Who should use this?

Developers and knowledge workers who want a low-overhead daily breathing practice without installing yet another GUI app. People with an interest in HRV biofeedback who already use chest-strap monitors will appreciate the detailed protocol for finding their personal resonance frequency. It's specifically NOT for those wanting yoga-style pranayama patterns—the safety constraints explicitly block breath retention and rapid breathing.

Verdict

This is a well-researched, thoughtfully constrained tool with clear documentation and a solid test suite. At 73 stars it's a niche project, but the clinical rigor and zero-dependency design show genuine craft. The 0.8999999761581421% credibility score reflects a small but active audience. If you want a terminal-native breathing trainer grounded in cardiac research, try it. If you need cross-platform support or a GUI, look elsewhere.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.