UniPet: app and UI for Hermes Agent

Desktop pet that shows the live status of Codex, Claude Code, Hermes, OpenClaw and other agents

What UniPet does

UniPet is a local visual status layer for AI agents. A small animated desktop companion reflects idle, running, waiting, failed and review states, so you can tell when an agent needs attention without watching the terminal. Agents, hooks, scripts and plugins drive it through a localhost protocol over HTTP at 127.0.0.1:8768 or WebSocket at ws://127.0.0.1:8769/ws, with events carrying source, state, message, action and ttl.

Connectors exist for Codex and Claude Code through hooks, Hermes and OpenClaw through plugins, and DeepSeek-TUI through lifecycle hooks, while custom agents can call unipet state from scripts. Pets are Codex-compatible skins that can be searched, installed, switched and removed from the CLI. UniPet runs on Node.js and Electron, keeps events on the local machine and stores its config and installed pets under ~/.unipet.

Key features

Animated pet states for idle, running, waiting, failed and review
Hermes connector added with unipet agent add hermes
Local HTTP and WebSocket protocol for custom agents and scripts
Codex-compatible pet skins managed from the CLI
unipet doctor and unipet agent status for checking setup
Clean removal with unipet agent remove all

When to use it

Seeing at a glance when a Hermes session is waiting for input
Watching the status of several coding agents through one desktop companion
Wiring a custom script or agent to the pet with unipet state running

Who it is for: Developers who run Hermes Agent, Codex, Claude Code or similar agents and want a glanceable on-screen status indicator.

How it fits with Hermes Agent

It supports Hermes Agent as one of several agents, connecting through a Hermes plugin installed with unipet agent add hermes.

How to install UniPet

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

npm install -g uni-pet
unipet start
unipet demo
unipet agent add hermes

Requirements: Node.js with npm; UniPet runs on Electron and does not require Python

FAQ

What is UniPet?

UniPet is a universal desktop pet for AI coding agents. It is a local visual status layer that shows when an agent is thinking, running tools, waiting for input, failing or ready for review.

Does UniPet work with Hermes Agent?

Yes. Hermes is one of the supported agents, connected through a Hermes plugin that you add with unipet agent add hermes. Codex, Claude Code, OpenClaw and DeepSeek-TUI are also supported.

How do I install UniPet?

Run npm install -g uni-pet, then unipet start and unipet demo. Connect Hermes with unipet agent add hermes, and check the setup with unipet doctor and unipet agent status.