anttijalomaki/ringwhip

RingWhip is a joke project with a real function: it interrupts an AI coding agent that has stalled or gone quiet by sending it a keyboard interrupt and typing an impatient hurry up message, all triggered by flicking your wrist. The idea is that when your agent seems stuck thinking instead of working, a physical whip motion snaps it back into action. There are two ways to try it. The simplest is a no hardware demo you run with a couple of npm commands, which simulates the wrist flick using a keyboard shortcut so you can see the effect without owning any special equipment. Pressing that shortcut while a disposable terminal window is focused sends a Ctrl+C interrupt signal followed by a randomly chosen hurry up phrase and an Enter key press. The real version works with a specific popular smart ring device that contains a motion sensor. You build a small companion program written in Rust that connects to the ring over Bluetooth, pair it with the ring using a security key if it has not been paired before, and then start the main application, which is built with Electron and JavaScript. Once running, a genuine wrist flick detected by the ring's accelerometer triggers the same interrupt and message sequence as the demo. Because RingWhip genuinely sends keystrokes to whatever terminal window is focused, the documentation warns strongly against testing it while an unsaved file or an important command is on screen, since the interrupt and typed text will actually be sent there. Extra setup steps are needed for certain Linux terminal programs and for macOS, where the app needs special permission to control the keyboard. Behind the scenes, the ring connects over Bluetooth, streams motion readings to the main Electron program, and that program calculates whether the motion looks like a deliberate flick before triggering the interrupt sequence, with built in safeguards so accidental double triggers or overlapping detections are ignored.