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 run xattr -d com.apple.quarantine ComiPet.app first.
  • 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/ivenkoolabdesktop-pet.svg)](https://yunodb.com/tools/ivenkoolabdesktop-pet?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/ivenkoolabdesktop-pet?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/ivenkoolabdesktop-pet.svg" alt="Featured on YunoDB" height="20"></a>