// attention router

Comsat

A local desktop radar that routes your attention between parallel AI workspaces. Each agent gets a colored tile. The tile tells you what its agent is doing — and flashes when it needs you next.

// for laypeople

Running one AI agent is easy. Running five at once — across different projects, in different windows — turns into a guessing game about which one is finished, which one is stuck, and which one is silently waiting on you.

Comsat solves that with a small radar that sits on the desktop. Every workspace becomes a colored tile. The tile shows what the agent is doing right now: working, finished, errored, or asking permission. When a tile lights up, you click it and the right window jumps to the front.

It is the difference between supervising a team and being interrupted by one.

// for builders

Comsat is a local Electron app that binds to 127.0.0.1:47321 and exposes three endpoints — /health, /state, and /event. Agent hooks (Claude Code stop/permission hooks, VS Code task hooks, anything that can curl) post status events keyed by workspace ID. The radar renders each workspace as a tile and updates its color and animation based on the latest event.

Event vocabulary: working, needs_permission, needs_input, done, error, idle, heartbeat. Click-to-focus uses macOS Accessibility APIs through AppleScript to raise the matching VS Code or Cursor window — title-match rules in ~/.comsat/config.json decide which window belongs to which tile.

No outbound network calls. No accounts. Config and state live in ~/.comsat/. The whole thing is rebuildable in a single command — designed to be a piece of cockpit furniture, not a service.