v4.7.0 - Focus Flow: Anti-Distraction Micro-Tasks

What's New

Focus Flow turns Claude's thinking time into mindful micro-engagement. Instead of reaching for your phone while Claude processes complex tasks, a lightweight activity launches automatically — and auto-closes the moment Claude finishes.

How It Works

You submit prompt → Claude starts thinking → (15s delay) → Micro-task activates
                                                              ↓
                                              Claude finishes → Auto-closes

Available Modes

Mode	What Happens
breathing	Opens a terminal with guided breathing exercises — visual progress bars, emoji prompts, configurable patterns (4-7-8 calming, box breathing, energizing)
hydration	Desktop notification with random wellness reminders: drink water, stretch, check posture, rest eyes, or take deep breaths
url	Opens a URL in your browser (GitHub issues, Jira board, daily notes, etc.)
command	Runs any custom shell command you define

Quick Start

Add to config/user_preferences.json:

{
  "focus_flow": {
    "enabled": true,
    "mode": "breathing",
    "min_thinking_seconds": 15,
    "breathing_pattern": "4-7-8"
  }
}

Or ask Claude Code: "Enable Focus Flow with breathing exercises"

Breathing Patterns

Pattern	Description
4-7-8	Calming technique: inhale 4s, hold 7s, exhale 8s (3 cycles)
box	Navy SEAL focus technique: equal 4s phases (3 cycles)
energize	Quick energizer: fast inhale 2s, hold 2s, slow exhale 4s (4 cycles)

Design Details

• Smart delay: min_thinking_seconds (default: 15) prevents micro-tasks from flashing for quick 2-second responses
• Auto-cleanup: PID-based process management — micro-task terminal window closes automatically when Claude finishes
• Zero blocking: Focus Flow runs entirely in background processes, never slows Claude
• Marker-file state: Same proven pattern as the snooze system — no daemons, no cleanup needed

Upgrade

cd claude-code-audio-hooks
git pull origin master
bash scripts/install-complete.sh

Then restart Claude Code.

Full Changelog: v4.6.0...v4.7.0