Skip to content

Repository files navigation

Pets Driven

Pets Driven

Desktop pets that show what your Claude Code and Codex CLI agents are doing

Latest release Downloads License: MIT Platform Built with Tauri

English · 한국어 · 日本語 · 简体中文

How you use it · Petdex integration · Features · Download

Pets Driven is a Windows desktop pet app for people who run AI coding agents. Hooks from Claude Code and the OpenAI Codex CLI hand the pet whatever the agent is doing, so one look at your desktop tells you whether the run is working, waiting on you, finished, or failed — no terminal to sit and watch for a task that ends whenever it ends. One pet per project directory, so several agents running at once stay readable at a glance. It's built with Tauri and React, MIT licensed, and ships a pdd CLI that does everything the app does.

🎬 How you use it

1. Pick a pet and bind it to a project

Choosing a pet and sending it out to the desktop

One pet per directory. Pick one from the cards and it walks out onto your desktop.

2. Use your terminal as usual

A pet reacting to an agent running in the terminal

Run your agent the way you always do, and the pet shows its status for you.

3. Take one out and play, even with nothing running

Taking a pet out to play on the desktop, unrelated to any task

Your pets are on the desktop whether or not work is running. Take them out, toss them around, hand them a treat.

4. When it's done, the pet calls you

A pet reacting to a finished task

Completed, failed, and waiting all make the pet stop and flag you. Pet it or click it.

🐾 Petdex integration

Pets Driven integrates with Petdex. As of August 24, 2026, Petdex offers more than 4,579 open-source pet assets.

npx petdex install <slug>

Pets installed with this command are stored in ~/.petdex/pets. Pets Driven automatically discovers this directory and lists its pets during onboarding and pet selection, ready to bind to a working directory.

🧩 It does this too

A pet running alongside the Codex CLI Codex works too
Not Claude Code only. Pets react through the same hooks in the OpenAI Codex CLI.
Pets playing together on their own Leave them alone and they play
With nothing to do, pets greet each other, chat, and give chase. They don't only live while you're watching.
A pet hatching for each Orca worktree Works with Orca
Two lines in your worktree hooks — pdd hatch and pdd delete — are all it takes. Every worktree gets its own pet, and clearing the worktree clears the pet with it.
How to set it up

✨ Features

  • 🔔 It tells you when work finishes
  • 🧠 A real little mind, 👥 pets socialize, 🎭 personalities & assets
  • ⌨️ The CLI does all of itpdd alone hatches a pet, renames it, re-skins it, re-tempers it, and deletes it. It works with the app closed, and its JSON output pipes straight into a script. The installer ships it and puts it on your PATH. → Full command list
  • 🤖 Agents drive it themselves — plugins for both Claude Code and Codex are included. hatch creates a pet, bring pulls a repo into a worktree, and carry hands the work off to the next agent. Hooks forward agent events to the app, so the pet reacts. → Browse the plugin

⬇️ Download

Download for Windows

The badge downloads the newest installer directly. Run the .exe and you're done. Want to see what's in it first? Browse the latest release.

macOS and Linux builds aren't published yet. The app is built with Tauri, so they're on the roadmap. Until then, please build from source.

📄 License

MIT © 2026 pets-driven contributors.

About

Desktop pets that show your Claude Code / Codex CLI agent status and tell you the moment a task finishes. Windows app built with Tauri.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages