his brood — one baby crab per running subagent

Craby

A pixel crab that watches your development workflow.

A presence interface for your Mac — Claude Code is the flagship integration, and the protocol is open to any brain that can speak HTTP.

brew tap duperez/craby && brew install --cask craby

macOS 13+ · ~300 KB · zero dependencies · MIT

View on GitHub Read PROTOCOL.md

Try it — right from this page

states · session "website"

structured event · /event

sources give attribution — the caption on the pet says who's calling

keeping watch · /watch · id "website-demo"

alive lands in the tooltip and menu · dead raises an attention event

party · /celebrate

—

This page is a static site on GitHub Pages — it drives the pet through the exact same open protocol every other integration uses. Any app can talk to Craby. Even a web page.

Addons

An addon is a folder: a manifest plus one executable. Craby runs the executable on an interval — it polls the real thing (CI, a server, a container) and reports back via /event and /watch. The manifest also picks a scene and paints a costume, so the crab dresses for the job.

// addon.json — the real github-watch manifest
{
  "name": "github-watch",
  "description": "GitHub CI on the pet (gh)",
  "exec": "run.sh",
  "source": "ci",
  "interval": 30,
  "scene": "atento",
  "props": { "garra": ["CW.", "CCG", "..G"] }
}
# one folder = one addon
~/Library/Application Support/Craby/addons/
└── github-watch/
    ├── addon.json  ← manifest + costume
    └── run.sh      ← polls, reports, exits

# github-watch and live-watch ship as
# editable seeds — copy one and go

🧩 Build a costume right here

Pick a scene, then paint inside the yellow-bordered cells — each bordered area is a slot (claw, floor, desk, head, sky…). Hover a cell to see the slot name. Only painted slots make it into the JSON.


    

    
Save it as ~/Library/Application Support/Craby/addons/<name>/addon.json next to your executable, then flip it on in the 🦀 menu.

  







  
How it works

  

    
1 · hooks
Claude Code hooks report to the pet on localhost:4923 — typing, finishing, needing you. Permission bubbles long-poll until you click.

    
2 · addons
Addons keep watch over CI runs, dev servers and containers, dressing the crab with a scene and props while they're on duty.

    
3 · anything
Any script that can curl speaks the same protocol. It's small, documented and open: PROTOCOL.md.

  







  
Everything else