Getting Started

One-Line Install

curl -sSL https://raw.githubusercontent.com/Flow-Club/vibereps/main/install.sh | bash

This installs the menubar app (recommended). For browser-only mode:

curl -sSL https://raw.githubusercontent.com/Flow-Club/vibereps/main/install.sh | bash -s -- --webapp

Then:

1. Restart Claude Code
2. Run /vibereps to choose your exercises

Alternative: Install from Local Clone

git clone https://github.com/Flow-Club/vibereps.git
cd vibereps
./install.sh

Uninstall

~/.vibereps/install.sh --uninstall

Requirements

• Python 3 (standard library only!)
• Modern web browser (Chrome, Firefox, Safari)
• Webcam
• Internet connection (for MediaPipe CDN)

How It Works

VibeReps uses Claude Code hooks to trigger exercises:

1. PostToolUse hook: When Claude edits a file, the exercise tracker launches
2. You exercise: Keep moving while Claude continues working
3. Notification hook: When Claude finishes, you get a desktop notification

The workflow looks like:

You: "Hey Claude, refactor this code"
    ↓
🏋️ Exercise tracker launches (5 squats)
    ↓
You exercise  ←→  Claude processes your request
    ↓
Exercise complete → "⏳ Claude is working..."
    ↓
Claude: "Here's your refactored code"
    ↓
🔔 Desktop notification: "Claude is ready!"

Verify Installation

After installing, run /hooks list in Claude Code to verify the hooks are registered:

PostToolUse:
  - matcher: Write|Edit|MultiEdit
    command: ~/.vibereps/exercise_tracker.py post_tool_use '{}'

Notification:
  - matcher: (empty)
    command: ~/.vibereps/notify_complete.py '{}'

Testing

You can test the tracker manually:

# Test quick mode with specific exercises
VIBEREPS_EXERCISES=squats,jumping_jacks ~/.vibereps/exercise_tracker.py post_tool_use '{}'

# Test notification (run in another terminal while tracker is open)
~/.vibereps/notify_complete.py '{}'

Claude Code Skill

After installing, use the /vibereps command in Claude Code. It handles everything based on context:

• Setup/install → Runs installer or configures hooks
• Test/launch → Starts the exercise tracker
• Add exercise → Guides through creating custom exercises
• Tune detection → Helps adjust thresholds if reps aren't counting

You can also install the skill via skills.sh:

npx skills add Flow-Club/vibereps

Next Steps

• Configure exercises and reps
• Learn about available exercises
• Set up monitoring dashboard