English | 中文 | 日本語 | 한국어 | Español | Français
A desktop pet that monitors your AI coding agents in real time. Supports macOS and Windows.
Code Mode
macOS: OpenClaw, Claude Code, Cursor, Codex, OpenCode, Gemini CLI, Hermes Agent
Windows: OpenClaw, Claude Code, Cursor, Codex, OpenCode, Gemini CLI, Hermes Agent (remote SSH)
Pet Mode
- Reacts to OpenClaw / Claude Code / Codex / Cursor / Gemini CLI / Hermes Agent activity in real time (working, idle, waiting)
- Desktop pet character animates when agents work and sleeps when idle (macOS notch or Windows taskbar)
- macOS: hover over the notch area to reveal the session detail panel
- Auto-discovers local OpenClaw agents with session lists, chat history, and daily calls/tokens charts
- Listens to local Claude Code, Codex, Cursor, and Gemini CLI sessions via hooks, view live conversations
- Gemini CLI token usage statistics via local telemetry
- Connect to remote OpenClaw / Hermes Agent instances running on servers via SSH
- Custom character animations, pair different agents with different characters
- Customizable island backgrounds with crop tool
- Completion & waiting sound effects
- macOS or Windows
- OpenClaw, Claude Code, Codex, Cursor, Gemini CLI, and/or Hermes Agent installed
OpenClaw Agents ──→ JSONL session files ──→ Health polling ──→ Activity state
Claude Code ──→ Hooks ──→ Event parser ──→ Activity state
Codex ──→ Hooks ──→ Event parser ──→ Activity state
Cursor ──→ Hooks ──→ Event parser ──→ Activity state
Gemini CLI ──→ Hooks ──→ Event parser ──→ Activity state
Hermes Agent ──→ Plugin ──→ Event parser ──→ Activity state
↓
Animated sprites ← State machine ← Sound effects
OC-Claw polls OpenClaw session files to detect agent activity, and listens to Claude Code, Codex, Cursor, Gemini CLI, and Hermes Agent via installed hooks/plugins. Activity states drive character animations on the notch island (macOS) or taskbar area (Windows), with an expandable panel for session details, chat history, and metrics.
- Tauri v2 + React + TypeScript — frontend
- Rust — backend for system interaction, SSH tunneling, and API communication
- macOS / Windows native APIs for window management and positioning
cd frontend
npm install
npx tauri devBug reports, feature suggestions, and pull requests are welcome.
Thanks for the support and feedback from the friends at LINUX DO.
- Notchi — design inspiration for notch companion concept and grass island
- Vibe Island — interaction design reference
MIT
Originally created at KAON Hackathon