duperez/crab-companion

Crab Companion is a macOS app that puts a tiny pixel art crab named Craby on your screen to show you what Claude Code, an AI coding assistant, is doing at any moment. Instead of alt-tabbing back to the terminal to check whether a long task has finished, you glance at the corner of your screen where Craby is idle, working at a tiny laptop, celebrating with sparkles when done, or waving with an exclamation mark when it needs your attention. The most useful feature is that Craby can answer Claude Code's questions for you. When Claude asks for permission to run a command, a speech bubble opens under the crab showing what it wants to do, with Allow, Deny, and Terminal buttons, and risky commands like deleting files or force pushing get a red border as a warning. There is also a local HTTP API that lets Claude, or any script, ask multiple choice or free text questions through the same speech bubble, falling back to the normal terminal prompt if nobody answers in time. If you run several Claude Code sessions at once, Craby shows the most important status across all of them and lets you click to jump to the project that needs you. When Claude spawns subagents, each one appears as a small baby crab below Craby, hatching when it starts and turning into sparkles when it finishes, so you can tell at a glance, or even by sound, how many subtasks are running and whether they succeeded. The app also tracks daily stats like tasks finished and a day streak, and Craby levels up the more you use it. Craby works by having Claude Code's built-in hooks send small messages to a local server running on your Mac, and the crab reads those events to decide how to react. It can be installed through Homebrew, built from source, or downloaded as a prebuilt app, and it requires macOS 13 or later plus Claude Code itself to be useful. Every install method adds Claude Code hooks to your existing settings file, keeping a backup of your previous configuration.