git404hub

what is capsos-agent-tracker fr?

devkriter/capsos-agent-tracker — explained in plain English

Analysis updated 2026-05-18

36SwiftAudience · developerComplexity · 2/5Setup · easy

tl;dr

A macOS menu bar app that turns your Caps Lock key light into a live status indicator for Claude Code sessions.

vibe map

mindmap
  root((CapsLockLED))
    What it does
      Blinks Caps Lock light
      Shows Claude Code status
      Never reads keystrokes
    Tech stack
      Swift
      IOKit
      macOS
    Use cases
      Ambient status awareness
      Permission prompt alerts
      Hands-free session tracking
    Audience
      Claude Code users
      Mac developers
    Setup
      Drag to Applications
      Grant Input Monitoring

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Glance at your keyboard to see whether Claude Code is working, waiting, or done

VIBE 2

Get a visual alert when a Claude Code session needs a permission prompt answered

VIBE 3

Run Claude Code sessions without keeping the terminal window in view

VIBE 4

Build and self-sign the app locally as a Swift package

what's the stack?

SwiftIOKitmacOS

how it stacks up fr

devkriter/capsos-agent-trackereyadhammouda/pookifyverback2308/ytlite
Stars363636
LanguageSwiftSwiftSwift
Setup difficultyeasyeasymoderate
Complexity2/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires macOS, granting Input Monitoring permission, and right-click-to-open since it is not notarized.

in plain english

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.

prompts (copy fr)

prompt 1
Walk me through installing CapsLockLED and connecting it to my Claude Code hooks.
prompt 2
Explain how the Caps Lock light states map to Claude Code's session status.
prompt 3
Help me troubleshoot why my Caps Lock light isn't reacting to Claude Code.
prompt 4
Show me how the UserPromptSubmit, Stop, and Notification hooks are wired in HookInstaller.swift.

Frequently asked questions

what is capsos-agent-tracker fr?

A macOS menu bar app that turns your Caps Lock key light into a live status indicator for Claude Code sessions.

What language is capsos-agent-tracker written in?

Mainly Swift. The stack also includes Swift, IOKit, macOS.

How hard is capsos-agent-tracker to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is capsos-agent-tracker for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.