Claude Code · Codex · macOS · Windows
Good code.
Great company.
Meet Claude Pet, a desktop pet that keeps you posted on your Claude Code and Codex usage. Bring a little friend of your own to your Mac or Windows PC.
Free download · Open source · Requires a Claude Code or Codex login
✻ Planning the refactor…
$ codex
• Running tests
Example screen · Numbers are for illustration
Either one, in the same place
Claude Code.
Codex, too.
Use just Claude Code, just Codex, or both. Usage for whichever you’re signed in to on this computer appears side by side in the same pill, told apart by its logo.
Codex usage is read from the OpenAI API, so only the limits your account actually has are shown. Codex usually has a single weekly limit right now, so one line carries both the usage and the time left until it resets. There’s nothing to set up.
Example screen
A glance is enough
Less checking.
More making.
Claude Code’s session and weekly usage, Codex’s weekly usage (Codex has a single weekly limit today), and their reset times fit in one small summary pill. Which items appear depends on your account.
Example screen · Colors and the 50%/85% thresholds match the app · Spike alerts work for both Claude Code and Codex
Small moments, together
When it resets,
it hops.
When the server shows a Claude Code or Codex session has reset, the pet reacts. Double-click the pet and it jumps while refreshing your usage.
Example screen · The reset is shortened to 5 seconds
Today’s friend
Who’s joining
your next session?
The cat is built in, and the dog, fox, scorpion and elephant come bundled. Switch friends from the app’s right-click menu, or bring your own character by adding a compatible pet.json and sprite-sheet folder. Click a card and that friend follows your cursor. Turn it on or off with the button at the bottom right.
Little movements, close by
A desktop with
a life of its own.
Wander, then settle.
It strolls around the screen, walking over windows and the desktop or crossing to another monitor. Turn roaming off when you want it to stay put.
Make a little room.
Drag the pet to a new spot, and change its size from the right-click menu. Here, you can try it with the slider.
It says hi when your cursor comes by.
Bring your cursor close and it waves. Turn on the button at the bottom right, and the friend you picked in “Choose a friend” follows your cursor.
Bring home
a new friend.
Latest version v1.1.0 · Release notes
macOS
- Signed with a Developer ID and notarized by Apple
- All you need is a Claude Code or Codex login. If you’re asked for access to the Claude Code credential, allow it
- Find your chip under Apple menu ▸ About This Mac
Windows 10 · 11
- There is one Windows build, for x64. There is no separate build for ARM devices
- It is unsigned, so SmartScreen or other security warnings may appear
- Sign in to Claude Code or Codex on Windows first
What do I need to sign in to?
Being signed in to either Claude Code or Codex is enough. If you use both, both are shown.
Where does the usage come from?
For both Claude Code and Codex, it comes from the server, using the login on this computer. Numbers are never estimated from logs; local logs are read only to catch sudden spikes.
Is it free?
It’s free to download and open source. You don’t need to sponsor to use the app.
Which computers does it run on?
macOS 12 or later on Apple Silicon and Intel Macs, and Windows 10 or 11 on x64. There is no separate Windows ARM build.
Does it upload my prompts or code?
No. Local logs are read only on your computer, to catch usage spikes. Your existing Claude Code or Codex login is sent only to Anthropic or OpenAI to ask for your usage, and update checks contact GitHub. Prompts, transcripts and source code are never uploaded.
Why does Windows show a security warning?
The Windows builds are not code-signed, so SmartScreen or another security warning may appear, depending on your system settings and policies. The Mac builds are Developer ID signed and notarized by Apple.
How does it update?
On both macOS and Windows, the app checks for a new release every hour after launch, and “Check for updates…” in the right-click menu downloads and installs it inside the app.
Can I add my own pet?
Yes. Put a compatible pet.json and sprite-sheet folder in ~/.claude_pet/pets on a Mac, or %USERPROFILE%\.claude_pet\pets on Windows, and it appears in the right-click menu.
Cheer on Claude Pet
A little support
makes new friends.
Claude Pet is a free, open-source app made by one person. New pets, support for new providers, and upkeep on Windows and macOS all come from the developer’s time. Sponsorship is the biggest help in keeping that time going.
Every feature works the same without sponsoring. Starring the project on GitHub is a big cheer, too.