ntd4996/agentpet

A desktop pet for macOS & Windows that monitors your AI coding agents (Claude Code, Codex, Cursor, Gemini...) in real time, and grows as you code, feed it tokens, level it up, climb the leaderboard.

AgentPet – a desktop companion that watches your AI coding agents

What it is – AgentPet is a free, open‑source desktop application (macOS, Windows, Linux) that sits in your menu bar and shows the live state of the AI coding agents you run (Claude Code, Codex, Gemini, Cursor, etc.). At the same time a small animated “pet” floats on the screen, gaining experience and evolving as you spend tokens and finish sessions. All core functionality works completely offline; optional web sync, a public leaderboard, and cross‑device restore are added only if you sign in with GitHub.

Key features

  • Multi‑agent monitor – menu‑bar list with a coloured status dot, project name, what the agent is doing, and a real‑time timer. The tray icon shows a count and turns orange when any agent needs your input.
  • Desktop pet (tamagotchi) – the pet “eats” the tokens your agents burn and the sessions they finish, earning XP, leveling up through five stages and unlocking 14 achievements. Right‑clicking the pet shows a HUD with level, hunger, a 7‑day burn chart, and live Claude/Codex subscription limits.
  • Per‑project pets & usage dashboard – assign a pet to a folder; the dashboard breaks down token usage by project and by agent (daily / monthly charts). History of the last 90 days is stored locally.
  • Optional online profile – sign in with GitHub to publish your pet, appear on a community leaderboard, and sync progress across machines. No data leaves your computer unless you opt‑in.
  • Extensible agent support – 11 agents are pre‑configured; any command‑line tool can be wrapped with agentpet run -- <command>.
  • Custom pet packs – pets follow the open Codex pet‑pack format (pet.json + spritesheet). Users can browse, adopt, or submit their own packs via the web gallery.

Supported platforms

  • macOS 13+ – native Swift/SwiftUI app, notarized, auto‑updates via Sparkle.
  • Windows 10/11 (64‑bit) – Tauri (Rust) build, auto‑updates, per‑user install.
  • Linux (64‑bit) – same Tauri binary distributed as AppImage, .deb, .rpm; in‑app auto‑updates for AppImage.

Installation

  • macOS: brew install --cask ntd4996/tap/agentpet or download the signed .dmg from the GitHub releases page.
  • Windows: download the installer or portable zip from the website or releases page.
  • Linux: download an AppImage, DEB, or RPM; or run the one‑liner curl … | sh to fetch the latest AppImage.
  • Building from source (macOS) requires Xcode 16 / Swift 6; the Windows source lives under windows/ (Tauri + Rust).

How it works

  1. Install the hook for each AI coding agent in Settings → General.
  2. Run your agents as usual; AgentPet receives events over a Unix‑socket daemon.
  3. The pet reacts on screen, the menu‑bar icon updates, and XP/levels are recorded locally.
  4. (Optional) Sign in with GitHub to sync your pet, view the web profile, and compete on the leaderboard.

Community – translations in Vietnamese, Simplified/Traditional Chinese, and Japanese; community‑maintained ports (e.g., a Rust + GTK4 Linux version). Pets are contributed by users and licensed individually; the app itself is MIT‑licensed.

License – MIT for the application code; pet assets are not part of the repo and remain under their creators’ licenses.

Related

  • Project
    alvinunreal/openpets

    A desktop companion platform that puts animated pets on your screen, extendable via a plugin SDK and integrable with AI coding agents via MCP.

  • Project
    RealZST/HarnessKit

    A unified management app for AI coding agents that centralizes the configuration, extensions, and security auditing of multiple agents in one interface.

  • Project
    jamesrochabrun/AgentHub

    A macOS desktop hub for managing multiple AI coding agent sessions (Claude Code and Codex) with integrated terminal, GitHub support, and live previews.

  • Project
    tony1223/better-agent-terminal

    Better Agent Terminal (BAT) is a cross‑platform desktop app (Windows/macOS/Linux) built with Tauri 2 and React. It lets you manage multiple project workspaces, each with split‑panel terminals, a file browser, Git viewer, snippet manager, and an embedded AI coding assistant (Claude Code or OpenAI Codex). The AI runs inside the app, offering streaming output, permission modes, session resume/fork, and detailed usage stats. Optional integration with the `cx` CLI provides lightweight semantic code navigation. Install via Homebrew, AppImage, or a one‑line script; you can also build from source with Rust and Node. Ideal for developers who want a single window to run commands and interact with LLMs safely and efficiently.

  • Project
    asheshgoplani/agent-deck

    A command center for AI coding agents that allows users to manage, monitor, and orchestrate multiple agent sessions across different projects from a single terminal.