A desktop pet for Claude Code · macOS
A tiny crab that keeps an eye on Claude for you.
Claudia floats above all your windows and acts out what Claude Code is doing: reading, editing, running, thinking. When Claude needs you, the crab shows the prompt right there, and your answer goes straight back to Claude.
Free and open source · Rust + SwiftUI · macOS 14 or later
Claude wants to run a command
cargo test --workspace
Moods
Know what Claude is up to from the corner of your eye.
Every animation here is the real sprite sheet the app ships,
assets/crab/crab.json, drawn live in your browser.
Asleep
No active sessions.
Thinking
Looking up, thought dots.
Reading
Opening files.
Editing
Writing changes.
Running
Shell commands.
Searching
Grep and glob.
Browsing
Web search and fetch.
Delegating
A subagent is working.
Using tools
MCP servers.
Planning
Drafting a plan.
Compacting
Tidying up context.
Needs you
Bouncing “!”.
Done
Claws up, ready for review.
Something failed
Dizzy.
Prompts
Answer Claude without switching windows.
When Claude asks for something, the crab shows the same choices the Claude app does. Whichever you answer first wins, and the other one steps aside.
-
Permission requests
Yes, Yes and don’t ask again, or No with feedback for Claude.
-
Questions
Single choice, multiple choice, or type your own answer with “Other”.
-
Plan approval
Read Claude’s plan and approve it, or send it back.
Keyboard first
- ⌥⌘C
- Focus the top card from any app
- 1–4
- Pick an option
- Return
- Confirm
- Esc
- Deny
Focus goes back to the app you were using afterwards.
Also in the menu bar
- Hide or show the crab
- Do Not Disturb: prompts go only to the Claude app
- Reset position
- Launch at login
How it works
Small, local pieces held together with hooks.
- Claude Code Runs a hook on every event: tool use, permission request, stop.
-
claudia-hookA tiny shim that forwards the event and never blocks Claude. -
claudiadA Rust daemon that turns events into moods and keeps the prompt queue. - The crab A SwiftUI pet that listens over a local WebSocket and sends your answers back.
Everything except the macOS frontend is portable Rust. A Windows or Linux pet only needs a new frontend that speaks the documented protocol.
Safety
It never says yes on its own.
You approve everything
Every allow comes from your click or keypress.
Your rules still apply
Claude Code still checks your deny and ask rules after a hook allows something.
Local only
Sockets bind to
127.0.0.1and need the token in~/.claudia/token.Fails quietly
If the pet isn’t running, the hook exits silently and Claude behaves normally.
Nothing gets stuck
Quitting the pet hands any open prompts back to the Claude app.
Easy to undo
The installer backs up your settings, and
uninstall-hooksremoves everything.
Install
Download it, open it, hook it up.
For macOS 14 or later, on Apple Silicon and Intel. Works with the Claude Code CLI and the Code tab in the Claude desktop app.
-
Download and unzip
Get Claudia-x.y.z-macos.zip from the latest release, unzip it, and move Claudia.app to your Applications folder.
-
Open it
Claudia isn’t notarized by Apple yet, so macOS blocks it the first time. Open System Settings → Privacy & Security and click Open Anyway. You only do this once. Or, from a terminal:
xattr -dr com.apple.quarantine /Applications/Claudia.app open /Applications/Claudia.app -
Install the Claude Code hooks
Choose Install Claude Code Hooks… from the crab’s menu-bar icon.
Your existing
~/.claude/settings.jsonis kept and backed up. Claude picks up the hooks automatically.