breathe-cli-resonance-breathing

Paces terminal-based resonance breathing sessions with audio cues, presets, and session logging.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/reason-machines/devtools-skills --skill breathe-cli-resonance-breathing-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: breathe-cli-resonance-breathing
Source: https://github.com/reason-machines/devtools-skills/tree/main/skills/breathe-cli-resonance-breathing
Command: npx skills add https://github.com/reason-machines/devtools-skills --skill breathe-cli-resonance-breathing-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Practicing slow resonance breathing for vagal tone training and heart rate variability improvement requires consistent pacing, which is hard to maintain manually. This Skill guides you through configuring and running paced breathing sessions directly in the terminal with audio cues, visual progress, and automatic session logging. ## Core Features & Use Cases - Paced Breathing Sessions: Run guided breathing at 4.5-6.5 breaths per minute with customizable inhale-exhale ratios and durations from 1 to 60 minutes. - Time-of-Day Presets: Auto-selects balanced, extended, or calm presets based on the time of day, with support for custom routines. - Session Logging & Safety Constraints: Automatically logs sessions to a local file and enforces clinically grounded limits on breath ratios, cycle length, and exhale duration. - Use Case: A developer wants a daily 10-minute HRV training habit. They run a morning script that launches a quiet balanced session at 5s-5s ratio, logs adherence, and later tests personal resonance frequency using short sessions at different ratios alongside HRV biofeedback hardware. ## Quick Start Ask the assistant to help you install breathe-cli and start a 10-minute balanced breathing session with the default 5-5 ratio.

Frequently Asked Questions about breathe-cli-resonance-breathing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start a resonance breathing session in the terminal?▼

Run breathe with no arguments to auto-select a preset based on time of day, or specify one with breathe --preset calm. You can customize sessions with --duration for minutes and --ratio for inhale-exhale seconds, such as breathe -d 10 -r 5-5.

How do I find my personal resonance frequency for HRV training?▼

Test ratios from 6.0 down to 4.6 breaths per minute in short 3-minute sessions while recording HRV with a chest strap and software like Kubios. Use the frequency producing the highest RMSSD or widest heart rate oscillations.

Does breathe-cli work on Linux?▼

Breathe-cli runs on Linux but audio cues are not currently supported, so use the --no-sound flag. Sessions log to ~/.local/share/breathe/sessions.log on Linux systems.

Why does breathe-cli reject my custom breath ratio?▼

Ratios are rejected when the total cycle is under 8 seconds, the exhale exceeds twice the inhale length, or a three-number ratio with breath holds is used. Adjust phases so the cycle is at least 8 seconds and exhale is at most 2x inhale.

How do I fix audio not working in breathe-cli on macOS?▼

Check that afplay is available with which afplay and test it manually with a system sound file. If audio still fails, run sessions with the --no-sound or -n flag to disable audio cues.