desktop-pet
Comi (可米) — a tiny 3D plush desktop companion for macOS and Windows: hops around, waves, claps her clapperboard and keeps you company while you work. Optional
What is desktop-pet?
Comi (可米) — a tiny 3D plush desktop companion for macOS and Windows: hops around, waves, claps her clapperboard and keeps you company while you work. Optional local status bridge for DSH / ZCode / Claude Code / Cursor / OpenCode / Codex. Zero dependencies.
Overview of desktop-pet
What it is
Comi (可米) is a tiny 3D plush desktop companion for macOS and Windows. She hops around, waves, claps her clapperboard, and keeps you company while you work. An optional local status bridge is available for DSH / ZCode / Claude Code / Cursor / OpenCode / Codex. The application has zero dependencies and runs independently without Codex, accounts, or model APIs.
Key features
- Desktop roaming: eight-frame hop movement, accelerated movement; on Windows, walks along the taskbar and visible window tops, turns around or falls at edges, and drops when supporting windows close or move.
- Expressions and actions: six-frame blink idle, wave, five-frame bounce, happy, shy, clapperboard, sixteen-direction look-around, eyes-closed sleep, work, wait, check, disappointed, plus stretch, doze, and twist a Rubik's cube.
- Mouse interaction: single-click to bounce, double-click to be happy, drag with grab reaction, release with gravity fall and landing.
- Throw physics: fast flick sends Comi in a parabolic flight, bouncing off screen edges and landing with diminishing bounces; gentle drop lands in place.
- Smooth transparent rendering at approximately 60fps; macOS uses native transparent windows.
- Position memory and system notifications: restarts at last position (
~/.comi-pet/config.json); can send native system notifications for task completion, issues, or waiting confirmation. - Scriptable via local file control interface (docs/API.md): other plugins or command line can make Comi speak, play actions, or read status.
- Right-click menu grouped into categories: actions (daily interaction / work status / life actions), companionship (display mode, tracking source, carousel, bridge, notifications), language, about and updates.
Use cases
- As a standalone desktop pet for companionship while working.
- Integrated with coding assistants (DSH, ZCode, Claude Code, Cursor, OpenCode, Codex) via optional adapters to show status cards, waiting confirmations, and task summaries.
- For entertainment: watching Comi perform automatic action sequences, interact with mouse clicks and drags, and display seasonal actions (e.g., Halloween).
Getting started
Download packaged version (recommended): Download the zip for your platform from the releases page and extract.
- macOS 13+: Open
ComiPet.app. If the developer cannot be verified, right-click the app and select Open, or runxattr -d com.apple.quarantine ComiPet.appfirst. - Windows: Run
ComiPet.exe. No Python installation required. Run from source (for latest actions):bash # macOS: double-click start-mac.command, or zsh tools/build_macos.sh # first build requires Apple command line tools (xcode-select --install) open build/ComiPet.app # Windows: Python 3.8+ (with tkinter) python pet.py
License and pricing
The project is licensed under MIT. Comi character assets are AI-generated and owned by IvenKooLab. The software is open source and free.
Based on the project's public README and repository metadata.