whatisgithub

What is capsblink?

pavloshargan/capsblink — explained in plain English

Analysis updated 2026-05-18

0SwiftAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

Two Mac apps that blink your keyboard's Caps Lock light to notify you when a webpage changes or an AI coding agent finishes a task.

Mindmap

mindmap
  root((CapsBlink))
    What it does
      Watches a webpage
      Watches coding agents
      Blinks Caps Lock light
    Tech stack
      Swift
      llama.cpp
      Local LLM
    Use cases
      Get notified of score changes
      Know when an AI agent finishes
      Avoid refreshing a page repeatedly
    Audience
      Mac users
      Developers using AI agents
    Privacy
      Runs fully locally
      No accounts or telemetry
      Only network call is the watched page

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 build with it?

USE CASE 1

Get a keyboard light alert when a live sports score or webpage changes

USE CASE 2

Know instantly when a local AI coding agent like Claude Code finishes its turn

USE CASE 3

Avoid constantly refreshing a browser tab to check for updates

USE CASE 4

Build your own notification tool on top of the project's reusable Swift library

What is it built with?

Swiftllama.cppQwen2.5macOS

How does it compare?

pavloshargan/capsblinkaiduckman/claudeusage_latest_may2026arnabau/thermalpulse
Stars000
LanguageSwiftSwiftSwift
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencegeneralvibe coderdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires macOS and granting Input Monitoring permission so the app can control the keyboard's LED.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice, the bundled AI model uses a similarly permissive Apache 2.0 license.

So what is it?

CapsBlink is a pair of small Mac apps that use an unusual trick: blinking the Caps Lock light on your keyboard as a notification, without changing the actual Caps Lock setting. Neither app needs extra hardware and both run entirely on your own computer, with no cloud accounts or tracking involved. The first app, called CapsBlink, watches any webpage you give it a link to, such as a live sports score page, and blinks the light when the page changes in a way that matches instructions you type in plain English, like blink when the game score changes. The second app, CapsBlink Agents, instead watches local AI coding assistants such as Claude Code or Codex, and blinks the light when one of them finishes a task and is waiting for you. To decide when to blink, CapsBlink fetches the watched page every so often, strips it down to plain text, and checks whether the text actually changed in a meaningful way. Only when something meaningfully differs does it hand the text to a small AI language model that runs locally on the Mac, which then decides whether that change matches what you asked it to watch for. The keyboard's Caps Lock light is then blinked briefly and returned to its normal state. Both apps are installed as regular Mac applications downloaded from the project's releases page, and since they are not signed by an official Apple developer account, the first launch requires a small extra step to open them. The apps also need permission to monitor keyboard input, which is how they are able to control the light. Anyone comfortable with a Mac's command line tools can instead build the apps from source, and the project provides a reusable core library that other developers could build their own tools on top of. The project is released under the MIT license, and the small AI model it bundles uses the Apache 2.0 license.

Copy-paste prompts

Prompt 1
Help me install CapsBlink and set it up to watch a live score webpage.
Prompt 2
Explain how CapsBlink decides when a webpage has meaningfully changed before blinking the light.
Prompt 3
Walk me through building CapsBlink from source on my Mac using make.
Prompt 4
Show me how CapsBlink Agents detects when Claude Code or Codex finishes a task.

Frequently asked questions

What is capsblink?

Two Mac apps that blink your keyboard's Caps Lock light to notify you when a webpage changes or an AI coding agent finishes a task.

What language is capsblink written in?

Mainly Swift. The stack also includes Swift, llama.cpp, Qwen2.5.

What license does capsblink use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice, the bundled AI model uses a similarly permissive Apache 2.0 license.

How hard is capsblink to set up?

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

Who is capsblink for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.