AIbubu
A coding step counter for the AI era
Monitor your AI coding tool activity, turn it into step counts, and drive a desktop pet to walk.
Website · 中文 ·
https://github.com/user-attachments/assets/2b42508f-95e7-4a6b-b0eb-02efa23425c5
What is it?
AIbubu is a desktop pet app that monitors your usage of AI coding tools like Cursor, Claude Code, Codex, OpenCode, Trae, and quantifies your "coding activity" into steps — the more active you are, the faster your pet runs.
- Idle — you're slacking off
- Walk — you're coding at a gentle pace
- Run — you and AI are in great sync
- Sprint — you're on fire
Features
AI Tool Activity Monitoring
AIbubu monitors your AI coding tools in real-time through a pluggable adapter system — no hooks to install, no config to change. It reads existing local data (databases, logs, process info) passively.
- Cursor — polls the local SQLite database (
state.vscdb), maps Composer statuses like generating / streaming to high activity
- Claude Code — parses JSONL session logs under
~/.claude/projects/
- Codex CLI — parses
rollout-*.jsonl session logs
- OpenCode — parses JSONL session logs under
~/.local/state/opencode/
- Trae — monitors process CPU usage
- Process fallback — when the primary adapter finds nothing, each provider can fall back to process-level CPU detection automatically
- Multi-tool boost — using multiple AI tools simultaneously accelerates your pet's progression (2 tools ×1.8, 3+ tools ×2.5 speed multiplier)
- Extensible — add support for any tool by writing a TOML config file; 5 adapter types available (
sqlite / jsonl / process / file_mtime / vscode_ext)
Movement & Mood
Movement — your pet's speed reflects how long you've been actively coding:
| State | Condition | Score |
|---|
| Idle | No activity | 0 |
| Walk | Active < 60s | 25–49 |
| Run | Active 60s+ | 50–74 |
| Sprint | Active 180s+ | 75–100 |
A 45-second cooldown bridge keeps the pet moving during brief gaps between agent tool calls, so your coding flow feels continuous.
Mood — visual effects layer on top of movement:
| Mood | Trigger | Visual Effect |
|---|
| Sleepy 💤 | Idle for 10 minutes | Drifting "zzz" letters + breathing + dimming |
| Excited 🔥 | Sprint or activity score ≥ 90 | Speed smoke puffs + shake + glow |
| Normal | Default | No effects |
Pet Interaction
- Single click — pat reaction with floating ❤️ 💕 particles
- Double click — poke reaction with ❗ ❓ particles
- Hold & drag — grab the pet and drag it anywhere on screen (150ms hold threshold to distinguish from clicks)
- Right-click — open the social panel
- Hover tooltip — "Hold to drag" / "Click to interact · Right-click for menu"
Step Counter & Insights
- Daily steps — each monitor tick adds
⌊score / 10⌋ steps based on your current activity score
- 90-day history — stored locally, rolls over at local midnight
- Insights dashboard:
- 7-day and 30-day trend charts
- 24-hour activity heatmap
- AI tool usage breakdown (active minutes per provider)
- Consecutive active days streak
Skin System
8 built-in skins with custom import support:
| Vita | Tard | Mort | Doux | Boy | Dinosaur | Glube | Line |
|---|
| | | | | | | |
- Custom import — import from folder or ZIP archive
- Multiple formats — Sprite Sheet (PNG), Lottie, GIF, APNG
- 4 required animation states — idle / walk / run / sprint, each with configurable frame rate, frame count, and start frame
- Downloadable template — built-in example with creation guide
LAN Social
- Auto-discovery — UDP broadcast on port 23456, finds teammates on the same network automatically
- Leaderboard — ranked by daily step count
- 5-second heartbeat — syncs nickname, steps, activity score, movement state, and skin in real-time
- Pet escort — online teammates appear as miniature pets walking alongside yours
- Privacy-first — LAN-only, no server, no account required
System
- Transparent window — frameless, transparent background, always on top, hidden from taskbar
- macOS fullscreen overlay — optionally keep the pet visible over fullscreen apps (NSPanel)
- System tray — show/hide pet, leaderboard, quit; tray icon updates with live pet sprite frames
- Launch at login — auto-start on macOS / Windows / Linux
- Auto-update — checks GitHub Releases for new versions, download and install in-app
- Bilingual UI — Chinese / English, auto-detects system language
- Theme — Light / Dark / System
- Privacy — all data stored locally, nothing uploaded to any server
- Cross-platform — macOS 14+, Windows, Linux (AppImage / deb)
Screenshots
Installation
macOS
Download the latest .dmg from Releases.
Requires macOS 14.0+
Windows
Download the latest .msi from Releases.
Linux
Download .AppImage or .deb from Releases.
Build from Source
Prerequisites
Steps
# Clone the repo
git clone https://github.com/funAgent/ai-bubu.git
cd ai-bubu
# Install dependencies
pnpm install
# Development mode
pnpm tauri dev
# Development mode (with mock peer data)
pnpm dev:mock
# Build for production
pnpm tauri build
Project Structure
packages/
├── app/ # Tauri desktop application
│ ├── src/ # Vue 3 frontend
│ ├── src-tauri/ # Rust backend
│ ├── providers/ # AI tool monitor configs (TOML)
│ └── public/skins/ # Built-in skin assets
└── site/ # Astro marketing site
scripts/ # Utility scripts
Adding Custom Providers
AIbubu's monitoring is driven by TOML config files. Adding support for a new AI tool is as simple as writing a .toml file — no code changes needed. See the Provider Configuration Guide for templates and instructions.
Tech Stack
| Layer | Technology |
|---|
| Desktop framework | Tauri 2, Rust |
| Frontend | Vue 3, Pinia, Vite |
| Website | Astro |
| Testing | Vitest |
| Tooling | pnpm workspace, ESLint, Prettier, Husky, commitlint |
Contributing
Contributions are welcome! Please read CONTRIBUTING.md for details.
Contributors
Contact
Support
If AIbubu makes your coding sessions more fun, consider giving it a ⭐ — it helps others discover the project!
Star History
Credits
- Pixel dinosaur characters by arks (itch.io)
License
MIT
