Skip to content
noggin

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.

  • Direct from hook: simplest, rejected for port contention and hook latency.
  • Queue instead of drop: rejected; stacked gestures look twitchy and carry stale meaning.

The process is called the noggin service (folder noggin/, launchd label com.noggin), not “the Daemon”. Same design.

byYellow PineYellow Pine

noggin v0.2.26-6-g09bf9b7 · 09bf9b7