Open source · Rust + GTK4 · Ubuntu 22.04+

Watch every agent.
At a glance.

An ambient desktop pet + tray monitor that shows your AI coding agents at a glance — working, done, or waiting for you.

Built on AgentPet (macOS) — star the original
$ curl -fsSL https://raw.githubusercontent.com/tranhuuhuy297/agentpet-linux/main/install.sh | bash
Works with Claude Code Codex
Activities
🙂 2 14:32
AgentPet — Monitor
Claude Code · working
Three ways to know

One signal, everywhere you look.

One state machine drives three ambient surfaces. Glance at any of them.

Tray icon

A paw in your top bar shows the running count — and flips to a warning the moment an agent needs you.

Monitor window

A live list of every session: project, activity, a colour-coded dot, and a per-state timer.

Desktop pet

A floating companion whose mood mirrors your agents, with a colour-coded label that spells out the state — working, waiting, or done — so there's no guessing. It follows you across every workspace.

Get started

Up and running in three steps.

Ran the install command above? Launch agentpet — it opens straight to Settings, where these three steps live.

1

Connect your agents

In Settings → General, toggle on the agents you use — AgentPet adds its hook safely, with backups.

Codex only — Codex runs trusted hooks only. In a new Codex session, run /hooks and trust agentpet hook --agent codex, or its pet won't show.

Any other CLI? Wrap it: agentpet run -- aider.

2

Add a pet from Petdex

Grab a slug from petdex.dev and install it with the Petdex CLI:

$ npx petdex@latest install snow-plum-lillia

Install as many as you like.

3

Pick a pet for each agent

In Settings → Pet, assign a pet to each agent. It appears when that agent is active — its mood mirroring the live state: calm, busy, or waving.