oc-claw  by rainnoon

Desktop pet for monitoring AI coding agents

Created 3 months ago
322 stars

Top 84.1% on SourcePulse

GitHubView on GitHub
Project Summary

A desktop pet application designed to monitor AI coding agents like OpenClaw, Claude Code, Codex, and Cursor in real-time. It targets developers who utilize these AI assistants, offering a personalized and visually engaging way to track agent activity, session details, and resource usage directly from their desktop. The primary benefit is enhanced awareness and control over AI coding workflows without constant context switching.

How It Works

The application employs a Tauri v2 framework, featuring a Rust backend for system interactions and an API, coupled with a React/TypeScript frontend. It monitors OpenClaw agents by polling JSONL session files and performing health checks. For Claude Code, Codex, and Cursor, it integrates via local hooks to capture events. These inputs feed into a state machine that drives animated character sprites and custom sound effects, providing visual cues for agent status (working, idle, waiting). The system supports macOS notch and Windows taskbar integration for unobtrusive monitoring.

Quick Start & Requirements

  • Requirements: macOS or Windows operating system; installation of OpenClaw, Claude Code, Codex, and/or Cursor agents.
  • Installation: Navigate to the frontend directory, run npm install, then execute npx tauri dev.
  • Documentation: Primary information is available within the repository's README.

Highlighted Details

  • Real-time activity monitoring for multiple AI coding agents.
  • Customizable desktop pet characters and interactive island backgrounds with a crop tool.
  • Auto-discovery of local OpenClaw agents, displaying session lists, chat history, and daily call/token charts.
  • Capability to connect to remote OpenClaw instances via SSH tunneling.
  • Visual integration with macOS notch and Windows taskbar.

Maintenance & Community

  • Contributions: Bug reports, feature suggestions, and pull requests are welcomed.
  • Community: No specific community channels (e.g., Discord, Slack) are listed in the README.

Licensing & Compatibility

  • License: MIT License.
  • Compatibility: The MIT license permits broad usage, including commercial applications and integration with closed-source projects.

Limitations & Caveats

  • The application is currently limited to macOS and Windows operating systems.
  • Functionality is dependent on the correct installation and accessibility of supported AI coding agents and their respective monitoring interfaces (hooks or session files).
Health Check
Last Commit

3 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
1
Issues (30d)
6
Star History
53 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.