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

Starting up…
Try a mood:

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.

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.

  1. Claude Code Runs a hook on every event: tool use, permission request, stop.
  2. claudia-hook A tiny shim that forwards the event and never blocks Claude.
  3. claudiad A Rust daemon that turns events into moods and keeps the prompt queue.
  4. 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.1 and 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-hooks removes 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 Claudia View the source on GitHub

  1. Download and unzip

    Get Claudia-x.y.z-macos.zip from the latest release, unzip it, and move Claudia.app to your Applications folder.

  2. 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
  3. Install the Claude Code hooks

    Choose Install Claude Code Hooks… from the crab’s menu-bar icon.

    Your existing ~/.claude/settings.json is kept and backed up. Claude picks up the hooks automatically.