Multitask with agents. Lights guide you back.
Fire off tasks across windows, then go work in Slack, email, or anything else. The lights keep watch — the moment one turns green, you know exactly which agent to come back to. This plays automatically; it's the real behavior.
Your lights, your way.
Combine every agent into a single light, split them one-per-window, or shrink them into a tidy row of dots — vertical or horizontal, any size, labels on or off. This is the exact look you get on screen. Try it:
Three colors. Zero ambiguity.
Your turn. The agent finished cleanly and is waiting for your input.
Working. The agent is thinking or running tools — go grab a coffee.
Needs you now. The agent is waiting for you to answer a question or approve something — or a turn hit an error.
Idle. No recent agent activity recorded for that window.
Tiny app. Big focus.
It does one thing perfectly: tells you when to look at your agent — and when you can ignore it.
Menu bar + floating lights
A colored dot lives in your menu bar, plus optional always-on-top traffic lights you can drag anywhere on screen.
One light per window
Running agents in five windows at once? Get five lights — or switch to a single combined light. Your call.
Cursor & Claude Code
Hooks into both tools. Auto-installs on first launch — works the moment your agent starts a turn.
Resizable, your way
Scale the lights from subtle to impossible-to-miss, toggle labels, and pick combined or per-window layout.
Completely local
State lives in a small JSON file on your Mac. No servers, no accounts, no telemetry. Nothing leaves your machine.
It listens — it never interferes.
AgentLights installs lightweight, observe-only hooks. They record state to a local file and never block, deny, or rewrite anything your agent does.
Agent hooks
A hooks.json entry maps Cursor's turn events — submit, tool use, stop — to a tiny shell script that writes the current state per conversation.
settings.json hooks
The same script wires into Claude Code's lifecycle events. If ~/.claude exists, AgentLights sets it up automatically.
One plan. Everything included.
Less than a coffee a month for a calmer way to run your agents.
- ✓ One light per window and per tab
- ✓ Every layout — traffic light, row of dots, combined
- ✓ Vertical or horizontal, any size, drag to reorder
- ✓ Cursor & Claude Code support
- ✓ 100% local — nothing leaves your Mac
- ✓ All future updates
Up and running in a minute.
Download the app
Grab AgentLights.dmg for macOS 13 or later — Apple Silicon & Intel.
Drag to Applications
Open the .dmg and drop AgentLights into your Applications folder. Don't run it from inside the .dmg.
Look up, not down
AgentLights has no Dock icon. After you open it, look for a colored dot (●) in your menu bar at the top of the screen.
Start an agent
Hooks auto-install. Kick off a Cursor or Claude Code turn and watch the dot change color.
App won't open?
Make sure you dragged it to Applications before launching, and look for the ● dot in your menu bar — there's no Dock icon.
If macOS says it's "damaged," run: xattr -cr /Applications/AgentLights.app in Terminal.
Your agents. Your machine.
AgentLights watches local hook events and writes a small status file on your Mac. There are no accounts, no API keys, and no network calls — nothing ever leaves your computer.