🧘 Mindful-Claude - Guided Breathing During Waits

📝 About Mindful-Claude

Mindful-Claude helps you use the wait time when Claude is processing your requests. Instead of staring at a blank screen or feeling stuck, the app guides you through simple breathing exercises right in your terminal. These exercises last only as long as Claude takes to respond.

Breathing at a steady, slow pace improves your body’s stress response and focus. Mindful-Claude starts automatically when Claude begins thinking. It disappears when Claude finishes. You stay relaxed, centered, and ready for the next prompt.

🚀 How to Get Mindful-Claude

To start using Mindful-Claude on your Windows computer, follow these steps:

1. Visit the release page to download Mindful-Claude:
   Download Mindful-Claude
2. On that page, locate the latest release. Look for a file that ends with .exe (example: Mindful-Claude-Setup.exe).
3. Click the .exe file name to download it. Your browser will save it to your default downloads folder, usually Downloads.

💻 How to Install Mindful-Claude on Windows

1. Open your Downloads folder (or wherever the file saved).
2. Find the Mindful-Claude installer (the .exe file you downloaded).
3. Double-click the installer to start it.
4. Follow the on-screen instructions:
   • Agree to any terms if asked.
   • Choose the default install location unless you want to change it.
   • Let the installer complete the process.
5. Once installed, the program will be ready to use.

▶️ How to Run Mindful-Claude

Mindful-Claude runs automatically with Claude. If you use Claude in your terminal, Mindful-Claude starts a breathing exercise when Claude begins working.

To use it:

1. Open your terminal or command prompt where you run Claude.
2. Start your Claude prompt as usual.
3. When Claude begins processing, Mindful-Claude will launch its breathing exercises automatically.
4. The breathing animation appears in the terminal. Follow the breathing pattern shown.
5. When Claude finishes, Mindful-Claude closes the animation.

No further action is needed to start or stop it.

🧘‍♂️ Breathing Exercises Included

Mindful-Claude offers four different breathing styles. Each helps you regulate your breath and calm your body:

• Box Breathing: Equal breathing in, hold, out, and hold phases.
• 4-7-8 Breathing: Inhale for 4 seconds, hold for 7, exhale for 8.
• Coherent Breathing: Breaths paced at about 5.5 breaths per minute.
• Resonant Breathing: Slow breathing that maximizes heart rate variability.

You can switch between these exercises in the settings after installation.

🎨 Animation Styles

The app shows your breathing with simple animations in the terminal. You can choose your preferred style:

• Pulse: Expanding gradient bars that rise and fall with breath.
• Ripples: Concentric lines spreading out like water drops.
• Dots: Moving dots that cluster and scatter slowly.
• Wave: A smooth bell curve that flows in rhythm.

⚙️ Adjusting Settings

After installation, you can adjust how Mindful-Claude behaves:

• Delay before start: Set how many seconds Mindful-Claude waits after Claude begins before starting breathing.
• Exercise choice: Pick your favorite breathing exercise.
• Animation style: Select the animation you find most soothing.
• Volume and sound: Turn on or off sound cues if available.

Settings are saved automatically and can be changed any time.

🖥️ System Requirements

Mindful-Claude works on Windows 10 or later. It requires:

• A terminal or command prompt where you run Claude.
• At least 100 MB of free disk space.
• Internet access only for downloading (not required to run after install).

No special hardware or extra software is needed.

⚡ Troubleshooting

If Mindful-Claude does not start automatically:

• Make sure you downloaded the Windows version.
• Check that you are running Claude in a compatible terminal.
• Restart your terminal or computer.
• Verify you installed the app using the .exe installer.

If issues continue, visit the release page for updates.

🔗 Download Mindful-Claude

Download the latest Windows installer here:

Click the link, then find and download the .exe file for Windows.

📖 Additional Help

For more details, check the documentation on the release page or open the README file included with the installer. The info covers usage tips, advanced settings, and troubleshooting. If you do not see progress animations, ensure your terminal supports it and that Claude is running correctly.