Ai Traffic Lights

🚦 AI Traffic Lights

**English** | [Português (Brasil)](README.pt-BR.md)

[](https://github.com/aronpc/ai-traffic-lights/actions/workflows/ci.yml)

A translucent always-on-top overlay (Electron) that shows the state of every **terminal AI agent session** on your desktop as a traffic light: 🟢 done · 🟡 working · 🔴 needs you.

Monitors **Claude Code**, **Antigravity**, **Codex** and **OpenCode** today. The architecture is agent-agnostic — new agents land via adapters (see [Adding an agent](#adding-a-new-agent)).

_One light per terminal AI session: 🟢 done · 🟡 working · 🔴 needs you. Animated: the red LED pulses. Static shot below._

Why

When you run several AI agent sessions in parallel across terminals, tabs and projects, you lose track of which one finished, which is still crunching, and which has been silently waiting for your approval for ten minutes. This overlay gives you one glance: a light per session, click to jump to its terminal — **window _and_ tab**.

Features

For the exhaustive implementation inventory — including known limitations, features implemented on the sync branch, and the roadmap — see the [feature and roadmap catalog (pt-BR)](docs/FUNCIONALIDADES.md).

• 🟢🟡🔴 One light per session, plus an aggregate light in the header
• 🤖 Four agents, one overlay: Claude Code, Antigravity, Codex and OpenCode
• 🌐 UI in English & Portuguese — follows the system locale, switchable in Preferences
• Click-to-focus: jumps to the session's terminal — the exact window, and in Warp the exact tab (via warp://session/) and in Tilix the exact terminal (via D-Bus TILIX_ID)
• 🔔 Beep + desktop not