his brood — one baby per running subagent
A tiny pixel-art crab that lives on top of your Mac screen and tells you what Claude Code is up to — and lets you answer back without touching the terminal.
git clone https://github.com/duperez/crab-companion.git
cd crab-companion
./install.sh
Requires macOS 13+, Xcode Command Line Tools, jq and Claude Code. ~300 KB, zero dependencies, MIT.
Floats above every app and every Space — even fullscreen. Never steals focus, no Dock icon.
When Claude asks for permission, click Allow / Deny right under Craby. Dangerous commands get a red border. No answer? Falls back to the terminal — Craby never decides alone.
Multiple-choice and free-text questions through the bubble, via a simple local HTTP API any script can use.
Several sessions at once? Craby shows the highest-priority state, dots for parallel work, and a tooltip per project. Click to jump to the session that needs you.
Spawn subagents and watch baby crabs hatch from eggs below Craby — they scuttle while the subagent runs, retire with a tiny cane and vanish in a star poof (gray poof if it failed). No other coding pet does this.
A mini animated Craby in the menu bar, always in sync. Collapse the floating one when you need a clean screen.
A soft pling when work finishes, a ping when Claude needs you. Toggle anytime from the menu bar.
Tasks finished, projects, time worked, recent events — and Craby levels up from hatchling to legend as work piles up.
Optional ntfy integration: if you're not at the Mac and Claude needs you, your phone gets a ping.
Sprites are text grids. Drop a sprites.json to reskin Craby entirely — cat, octopus, you name it.
Idle quirks, a sweat drop on long tasks, naps when nothing happens, and confetti when he levels up.
Claude Code ── hooks ──> localhost:4923 ──> 🦀 Craby (floating + menu bar)
^ │
└────────── decision (long-poll HTTP) ──────┘
UserPromptSubmit → typing on the laptop Stop → celebration
Notification → waving for attention PermissionRequest → bubble, waits for your click