Dr. Vibe is a 128x128 pixel character (32x32 sprites at 4x scale) that sits on your desktop in a transparent, always-on-top window. He's never in the way, but he's always watching.

He watches what you do Detects coding in 25+ apps (VS Code, terminals, IDEs) Tracks file changes, momentum, and project context Notices when you're stuck or fatigued He reacts expressively 16 animation states with squash/stretch physics Breathing, blinking, and random personality flourishes Smooth transitions between every state He keeps you healthy Hydration reminders, eye strain breaks, posture checks Overwork prevention and work-life boundaries He celebrates your wins Achievement system with progress tracking Personal best records, daily streak tracking Confetti and particle effects

Dr. Vibe on your desktop — speech bubbles, momentum meter, and focus mode

Dr. Vibe has 16 distinct animation states, each with unique frame counts, timing profiles, and per-frame duration arrays for organic movement.

When idle, Dr. Vibe is never truly still — he breathes, sways, blinks, and occasionally adjusts his goggles or waves.

12 character skins, each a full replacement spritesheet with unique art:

Each skin also supports palette-swapped skin tones applied in real-time via pixel-level canvas manipulation.

Dashboard Overview tab with streak, momentum, session stats, weekly chart, and personal bests	Session Stats Real-time coding ratio, activity timeline, and recent files
Sprite Editor Built-in pixel editor with frame navigator, color palette, animation preview, and minimap	Settings Appearance tab — skin selector, skin tones, walking behavior, and ghost mode
Achievements Unlocked achievements with dates and in-progress items with progress bars	Toast Notifications Glassmorphic toasts — color-coded by category with progress timers

• Coding detection across 25+ recognized apps (VS Code, terminals, IntelliJ, vim, etc.)
• Momentum tracker — maps file change frequency to 5 levels: cold, warming, flowing, hot, fire
• Stuck detector — heuristic detection of "spinning your wheels" patterns
• Fatigue detector — monitors declining edit frequency over long sessions
• Project detection — scans for .git, package.json, Cargo.toml, etc.

Deep integration with Claude Code through a hook-based event system:

• Hotspot commentary — notices when files get edited repeatedly (3+ to 25+ edits)
• Refactor radar — classifies sessions as research, rampage, or surgical
• Bug squash detector — recognizes fix-test-fix cycles and celebrates resolution
• AI pair programming — detects and celebrates overlapping human + Claude activity
• Session summary — natural-language wrap-up when a Claude Code session ends

• Pomodoro timer with configurable work/break/long-break intervals
• Break modes — strict pomodoro, smart (activity-adaptive), or manual
• Focus mode — dedicated distraction-free sessions with on-screen countdown
• Break activities — stretching, walking, hydration suggestions during breaks

• Hydration reminders with daily water intake counter
• Eye strain breaks — interactive 20-second 20-20-20 countdown
• Posture checks — rotating posture tips with countdown
• Work-life boundaries — configurable work-end time reminders
• Overwork prevention — warns on excessive continuous sessions

• Session tracker — time, files, edits, momentum, project, streak
• Skill tracker — cumulative time per language with milestones (1h to 100h)
• Personal bests — longest session, most files, highest momentum, most productive day
• Daily streaks — consecutive coding days with milestone celebrations
• Weekly summary — aggregated stats, trends, top files, achievements

Unlockable achievements across 9 categories: Getting Started, Consistency, Productivity, Languages, Focus, Wellness, Curiosity, Mastery, and Claude Code.

A built-in pixel art editor for customizing Dr. Vibe's spritesheet — frame navigator, drawing tools (pencil, eraser, fill, eyedropper), color palette, animation preview with FPS control, and a minimap of the full spritesheet.

Entirely procedural — no sound files. Everything is synthesized in real-time via Web Audio API.

9 voice presets: mumble, squeaky, gruff, alien, robot, mystic, hyper, retro. Each controls pitch, waveform mix, syllable timing, formants, and vibrato.

• Always on top — floats above all windows
• Transparent background — only the character is visible
• Click-through ghost mode — clicks pass through transparent areas
• Draggable — click and drag to reposition
• Walking behavior — randomly walks across configurable screen boundaries
• Position persistence — remembers placement between sessions
• Quit flow — shows "Today's Wins" summary before exiting

• Node.js 18+
• Rust 1.70+
• Tauri CLI 2.0+

npm install

# Development
npm run dev

# Production build
npm run build

dr-vibe/
├── src/
│   ├── core/                    # EventBus, TauriBridge, GameLoop, Database
│   ├── features/
│   │   ├── character/           # SpriteAnimator, Character, Reactions, Walking
│   │   ├── activity/            # ActivityMonitor, ClaudeCode, Momentum, Stuck
│   │   ├── timer/               # Pomodoro, TimerUI, BreakScheduler
│   │   ├── session/             # SessionTracker, Fatigue, Overwork, Weekly
│   │   ├── achievements/        # AchievementSystem, Definitions
│   │   ├── skills/              # SkillTracker (language time tracking)
│   │   ├── sound/               # Procedural audio engine
│   │   ├── hydration/           # Water reminders
│   │   ├── eyestrain/           # 20-20-20 breaks
│   │   ├── posture/             # Posture checks
│   │   ├── encouragement/       # Celebrations & encouragement
│   │   └── ...                  # focus, breaks, learning, resume, etc.
│   ├── ui/                      # Panel components
│   ├── config/                  # Animations, skin tones, resources
│   └── *.html                   # Window HTML files
├── src-tauri/                   # Rust backend (Tauri 2.0)
└── tools/                       # Sprite generation, hooks

All modules communicate through a centralized EventBus (publish/subscribe). No module directly calls another — 80+ named events keep everything decoupled.

50+ configurable settings across 7 categories:

See STATE-REFERENCE.md for the complete settings reference.

MIT