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

Build it, open it, hook it up.

You need macOS 14 or later, a Rust toolchain, and Xcode or the Command Line Tools for Swift.

View the source on GitHub

  1. Get the code and build the app

    git clone https://github.com/milangtoth/Claudia.git
    cd Claudia
    ./macos/build-app.sh
  2. Open it

    open dist/Claudia.app
  3. Install the Claude Code hooks

    Choose Install Claude Code Hooks… from the crab’s menu-bar icon, or run:

    dist/Claudia.app/Contents/Resources/bin/claudiad install-hooks

    Your existing ~/.claude/settings.json is kept and backed up. New Claude sessions pick up the hooks.