OC-Claw

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

What it does

• 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

Requirements

• macOS or Windows
• OpenClaw, Claude Code, Codex, Cursor, Gemini CLI, and/or Hermes Agent installed

How it works

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.

Tech Stack

• Tauri v2 + React + TypeScript — frontend
• Rust — backend for system interaction, SSH tunneling, and API communication
• macOS / Windows native APIs for window management and positioning

Development

cd frontend
npm install
npx tauri dev

Contributing

Bug reports, feature suggestions, and pull requests are welcome.

Friendship Link

Thanks for the support and feedback from the friends at LINUX DO.

Credits

• Notchi — design inspiration for notch companion concept and grass island
• Vibe Island — interaction design reference

License

MIT

Star History

---

_{Originally created at KAON Hackathon}