Terminal-first setup
Run one command. Petdex does the rest.
Install the desktop app, wire your coding agents, and wake your pet from the terminal.
Install & Wire Petdex
Copies the recommended terminal setup
For blocked terminals, manual macOS installs, or keeping the installer locally.
Terminal
$ npx petdex init
✓ Agent hooks installed
✓ Boba awake
Petdex Desktop
A floating pet stays beside Codex, Claude, Gemini, and OpenCode.
What it does
A pet that actually lives in your workflow
Cross-agent reactions
Hooks install in Claude Code, Codex CLI, Gemini CLI, and OpenCode. Your pet reacts to each tool call.
Always with you
Floating, frameless, on top. Drag with momentum, just like Codex Desktop.
Pick your fighter
Right-click cycles 9 sprite states. 200+ pets from the collection.
Get started
Set up in 30 seconds
- 1
Wire it up
Picks your agents (Claude Code, Codex, Gemini, OpenCode), writes hooks, and wakes the mascot
- 2
Stay updated
Pulls the latest desktop release and restarts the pet if it was running. Run any time.
Platform support
Where it runs
macOS
Apple Silicon and Intel
Linux
Coming soon
Windows
Coming soon
Want a faster Linux or Windows release? Star the repo or open an issue.