A developer desktop companion that grows with your coding activity.
CommitCat lives on your desktop, watches your development environment locally, and reacts to your work β commits, coding time, focus sessions, and more.
π± A tiny coding partner that never judges you (even at 3 AM).
- πΎ Desktop pet with pixel-art sprites β walks, sits, sleeps, and celebrates
- π£ Menu bar / system tray companion (streak tooltip)
- π±οΈ Draggable β place it anywhere on your screen
- π±οΈ Click-through β transparent areas pass clicks to the desktop
- π¬ Click to chat (speech bubble reactions with personality)
- π¬ Random coding messages β cat reacts while you code
- π¨ Multi-color cat (orange / brown / white)
- πΎ Petting β right-click & swipe to pet the cat with tiered reactions
- π€ Sleeps when you're away
- π₯οΈ Fullscreen-aware β auto-hides when you go fullscreen
- π Local Git commit & push tracking β reacts every time you commit
- π» IDE detection β knows when you're coding (VS Code, JetBrains, Xcode, and more)
- π Late-night coding awareness
- π± XP & level system β grows with your activity
- π₯ Streak system β 3/7/30-day milestones with bonus XP
- β¨ Pixel-art level-up animation with burst particles
- β±οΈ Pomodoro focus timer with break timer
- π Daily summary timeline (right-click β Today) β view commits, coding time, XP earned, and event history
- π GitHub integration β PR open/merge XP, star notifications
- π€ Claude AI chat β double-click the cat to chat with your AI companion (Anthropic API)
- 𧩠VSCode Extension β install from the VSCode Marketplace for seamless IDE detection
- π macOS Notification Center β system notifications for key events
- π Auto-update checker β notifies when a new version is available
- βοΈ Cloud API server β commitcat-api.fly.dev
- π Cross-device sync β event-based, offline-first
- π GitHub OAuth login
- π Animated SVG badge for GitHub README
- π€ Public profile page β level, XP, streaks, items
- π Global stats API
- π¦ VS Code Extension β coding time, file saves, build tracking, session stats in status bar
- π¦ JetBrains Plugin (IntelliJ, WebStorm, PyCharm, GoLand, CLion, RustRover) β coding time, file saves, build tracking
- βοΈ Settings panel β manage watched repos, cat color, timer durations, API keys, and XP progress
- π³ Docker activity awareness β container start/build detection with XP
CommitCat gains XP from:
| Activity | XP |
|---|---|
| Git commit | +10 XP |
| Git push | +5 XP |
| 1 hour of coding | +5 XP |
| Late-night session | +15 XP |
| Pomodoro complete | +20 XP |
| GitHub PR opened | +20 XP |
| GitHub PR merged | +30 XP |
| Docker container start | +5 XP |
| Docker build complete | +15 XP |
| 3-day streak | +50 XP |
| 7-day streak | +100 XP |
| 30-day streak | +500 XP |
Level up formula: Level n β n+1 requires n Γ 100 XP
The more you build, the happier it becomes.
CommitCat is designed for developers who care about privacy.
- β No code is collected
- β No keystrokes are recorded
- β No files are uploaded
- β No telemetry by default
βοΈ All data is stored locally on your machine βοΈ External integrations (GitHub, AI) are opt-in only
- β macOS
- β Windows
- β Linux
Download from the Releases page.
macOS
CommitCat.dmg
macOS Gatekeeper κ²½κ³ μ: μ±μ΄ μ½λμ¬μΈλμ§ μμ "μμλμκΈ° λλ¬Έμ μ΄ μ μμ΅λλ€" κ²½κ³ κ° λμ¬ μ μμ΅λλ€. ν°λ―Έλμμ μλ λͺ λ Ήμ΄λ₯Ό μ€ννλ©΄ ν΄κ²°λ©λλ€:
xattr -cr /Applications/Commit\ Cat.app
Windows
CommitCat-Setup.exe
Linux
CommitCat.AppImage # Most distros
CommitCat.deb # Debian/Ubuntu
Wayland (Hyprland, Sway λ±) μ¬μ© μ EGL μλ¬κ° λ°μνλ©΄:
WEBKIT_DISABLE_DMABUF_RENDERER=1 commit-catλλ X11 λ°±μλλ₯Ό μ¬μ©νμΈμ:
GDK_BACKEND=x11 commit-cat
Search "CommitCat" in the VSCode Extensions tab, or install directly from the Marketplace.
git clone https://github.com/eunseo9311/commit-cat.git
cd commit-cat
npm install
npm run tauri devRequirements: Node.js, Rust, Tauri CLI
- Tauri β lightweight desktop framework
- React β UI
- Rust β system integration, Git & IDE tracking
- Axum β cloud API server
- SQLite β local & cloud data storage
- Anthropic API β AI chat (optional)
MVP β
- Desktop pet rendering
- Activity & IDE detection
- Local Git integration
- XP & growth system
- Tray / menu bar UI
- Settings panel
v1.0 β Local Complete β
- Pomodoro focus timer with break timer
- Daily coding summary & event timeline
- GitHub integration (PR tracking, star notifications)
- Claude AI chat companion
- macOS / Windows / Linux support
- Docker integration
- IDE plugins (VS Code Extension, JetBrains Plugin)
- Petting interaction & click-through
v1.1 β Architecture Refactor β
- Cargo workspace +
commit-cat-corecrate extraction - Platform trait abstraction (
#[cfg]cleanup) - Remove duplicated model files in
src-tauri - State machine integration (core as single source of truth)
v1.2 β Design & Items β
- Item system foundation (hats, accessories, inventory UI)
- Grab sprite system (color-specific drag animations)
- AI provider/model selection (Claude + OpenAI GPT)
- Cat design renewal
- Item positioning & motion polish (per-state sprite alignment)
- Auto-equip items (birthday hat, commit streak crown, etc.)
v1.3 β IDE Plugins π§©
- JetBrains plugin marketplace preparation
- JetBrains Extension marketplace release
v1.4 β VSCode Webview π₯οΈ
- Cat rendering inside VSCode (Webview Panel)
- Environment detection (desktop / Codespaces / web)
v2.0 β Cloud βοΈ β
- Cloud API server (Rust + Axum) β deployed on Fly.io
- Cross-device sync (event-based, offline-first)
- GitHub OAuth
v2.1 β Badge & Profile π
- Animated SVG badge for GitHub README
- Public profile page
- Global stats API
- GitHub Codespaces support
v3.0 β Multi-Platform π
- Discord bot integration
- External app widgets
- Community features (leaderboard, team stats)
Contributions are welcome! See CONTRIBUTING.md for development setup, project structure, and PR guidelines.
- Code: AGPL-3.0 License
- Assets (sprites, icons, pixel art): All rights reserved. See public/assets/LICENSE. Not for redistribution or reuse without permission.
v2.1 in progress β badge & profile live at commitcat-api.fly.dev If you like the idea, consider giving the repo a β