A single noggin service owns the Link; hooks only relay to it
Claude Code hooks could open the USB serial port directly, but several sessions finishing together would fight over the port, and a hook that waits on a serial handshake slows every Claude response. Instead a launchd-managed noggin service holds the Link open and listens on a Unix socket; each hook writes one gesture name to the socket and exits immediately. The noggin service enforces Busy (drop while playing) and tolerates the Core being unplugged or unpowered.
Considered options
Section titled “Considered options”- Direct from hook: simplest, rejected for port contention and hook latency.
- Queue instead of drop: rejected; stacked gestures look twitchy and carry stale meaning.
Update 2026-10-31
Section titled “Update 2026-10-31”The process is called the noggin service (folder noggin/, launchd label com.noggin), not “the Daemon”. Same design.
noggin v0.2.26-6-g09bf9b7 · 09bf9b7