Agent Pet: app and UI for Hermes Agent

Floating desktop pet that reacts to Hermes Agent, Codex and Claude Code activity or WebSocket messages

What Agent Pet does

Agent Pet floats a transparent window on your desktop and plays Codex-compatible sprite animations: a 1536x1872 atlas with 8 columns and 9 rows of 192x208 cells, in WebP or PNG. It can monitor local activity for Codex CLI, Claude Code, opencode, OpenClaw, Hermes Agent and Antigravity, with source paths and optional source prefixes you can customize.

It also listens on a built-in WebSocket endpoint at ws://127.0.0.1:8765, so any script can drive the pet with a JSON message of type new_message, mention, error, processing, waiting_input, review_required, success or idle. Each type maps to an animation, and a pet.json file can change the mapping. Custom pets live in a user directory and take priority over built-in ones. Settings are reached from the system tray, with pet size presets and drag movement. The app checks pet IDs, sprite paths, file extensions and sprite dimensions. macOS and Windows have been tested locally, while Linux should work through Tauri but is not fully verified.

Key features

Codex-compatible sprite atlas pets, with custom pets loaded from a user directory
Local activity monitoring for Codex CLI, Claude Code, opencode, OpenClaw, Hermes Agent and Antigravity
WebSocket endpoint at ws://127.0.0.1:8765 for custom animation triggers
Floating transparent window with tray menu, settings window, drag movement and size presets
Validation of pet IDs, sprite paths, file extensions and sprite dimensions

When to use it

Seeing at a glance when a Hermes session is working, waiting for input or has failed
Driving a desktop animation from your own script through WebSocket messages
Drawing a custom pet sprite sheet for your agent setup

Who it is for: Developers who run one or more coding agents and want an ambient desktop indicator of what those agents are doing.

How it fits with Hermes Agent

A general tool that lists Hermes Agent among several agents whose local activity it can monitor; it is not specific to Hermes.

How to install Agent Pet

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/xiangking/agent-pet.git
cd agent-pet
npm install
npm run tauri dev

Requirements: Node.js 18+, Rust 1.77.2+, and the Tauri v2 platform prerequisites (Xcode command line tools on macOS, WebView2 on Windows, WebKitGTK and common Tauri system libraries on Linux)

FAQ

What is Agent Pet?

Agent Pet is a lightweight desktop pet that floats on your screen and plays sprite animations in response to AI agent activity or local WebSocket messages. It is built with Tauri v2, Rust, React and Vite.

Does Agent Pet work with Hermes Agent?

Yes, Hermes Agent is one of the tools whose local activity Agent Pet can monitor, alongside Codex CLI, Claude Code, opencode, OpenClaw and Antigravity. You can set custom source paths in the settings window.

What do I need to run Agent Pet?

You need Node.js 18 or newer, Rust 1.77.2 or newer, and the Tauri v2 prerequisites for your platform. The README builds the app from a cloned copy of the repository.