pham-tuan-binh/claude-knob

Claude Knob is a physical hardware accessory for Claude Code, a rotary knob you plug into your computer via USB that lets you control the Claude Code terminal interface with physical gestures instead of a keyboard. Rotating the knob clockwise sends a down-arrow keypress (to scroll or pick the next option), rotating counterclockwise sends up-arrow, a single tap sends Enter to confirm, a double tap sends Ctrl+C to interrupt, and holding for more than 300ms triggers a push-to-talk voice mode by holding Space. The hardware is a small round display board (the CrowPanel 1.28-inch HMI ESP32 Rotary Display) with a built-in rotary encoder, touch button, a circular color screen, and five RGB LEDs around the rim. When you use the knob, a small animated orange Claude mascot on the screen reacts to your gestures, bobbing at idle, walking when you turn, jumping on a tap, and bouncing while you hold. The LEDs chase like a comet in whichever direction you spin. The firmware is written in C using the Arduino framework and built with PlatformIO, a build tool for embedded devices. Setup involves cloning the repo, installing PlatformIO, and flashing the firmware to the board over USB. No soldering is required, the board ships fully assembled. An optional 3D-printable stand is included to hold the knob on your desk. The full README is longer than what was provided.