devkriter/capsos-agent-tracker

CapsLockLED is a small macOS menu bar app that turns your MacBook's Caps Lock key light into a status indicator for Claude Code. Instead of staring at your terminal to see what your AI coding session is doing, you glance at the Caps Lock key: a slow blink means Claude is working, a fast blink means it needs your attention such as a permission prompt or a question, and two quick flashes followed by darkness mean it just finished responding. Your Caps Lock itself never actually turns on, only the light is used, and the app never reads anything you type. Installing it is meant to be simple even for non-technical users. You open the provided disk image, drag the app into Applications, then right-click and choose Open the first time since it is not distributed through the Mac App Store. After granting the app Input Monitoring permission in macOS system settings, which is what lets it control the keyboard light, you click a menu item to connect it to Claude Code. From then on, every Claude Code session on that Mac drives the light automatically, and the menu bar icon itself also changes color to match. Under the hood, the app talks to the keyboard's hardware LED through IOKit, and a small command-line tool bundled inside it is what Claude Code's hooks actually call. Three specific hooks are added to the Claude Code settings file: one that fires when you submit a prompt, one that fires when Claude finishes and goes idle, and one that fires only for prompts where Claude is genuinely blocked waiting on you, so a normal completion is never mistaken for a request needing input. The project is built as a Swift package and can be compiled from the command line without Xcode. It is self-signed rather than notarized by Apple, so sharing the installer with someone else may trigger extra macOS security warnings on their machine.