Agent Signal Bar

Agent Signal Bar

Menu bar and floating desktop status lights for AI agents on macOS.

Keep Codex Desktop, Claude, and local automation visible from the menu bar or a draggable desktop signal light. Green means work is moving, yellow asks for attention, and red means you need to step in.

Download for macOS View source Releases
brew install --cask guan-ops/tap/agent-signal-bar

Free and open source. macOS 14+. Ad-hoc signed release builds today.

Red, Yellow, Green The right interrupt at the right time.

Green Idle, thinking, working, tool done, or complete.
Yellow Attention, notification, or stale state worth checking.
Red Permission request, blocked state, failure, or error.

A floating signal light that stays on your desktop

The desktop light syncs with the menu bar signal, supports dragging, resizing, vertical or horizontal layouts, a compact running-agent badge, and a small current-session popover.

  • Drag and resize the signal light wherever it belongs.
  • Switch between vertical and horizontal layouts.
  • Show a running-agent badge and current-session popover only when useful.
Agent Signal Bar floating desktop signal light with all three lights on and a running-agent badge

A tiny signal language for busy agent work

Agent Signal Bar turns noisy agent progress into a glanceable menu bar signal. It protects permission, blocked, and attention states so urgent work is not overwritten by normal background activity.

Animated preview of Agent Signal Bar light effects

Local-first by design

Status files, hook events, Codex Desktop session parsing, and diagnostics stay on your Mac. The app does not require a cloud account or telemetry backend to do its job.

  • State is read from local files and local agent logs.
  • Hooks are optional for Codex Desktop and useful for CLI/TUI workflows.
  • Diagnostics export is a local file you control.
Agent Signal Bar settings window with Liquid Glass enabled

Install

Use Homebrew for the quickest install, download the DMG from GitHub Releases, or run the SwiftPM app directly from the checkout.

Homebrew

brew install --cask guan-ops/tap/agent-signal-bar

Installs the latest published release through the guan-ops Homebrew tap.

Download release

  1. Open the latest GitHub Release.
  2. Download AgentSignalBar.dmg.
  3. Drag the app to Applications and launch it.
Open latest release

Run from source

./script/build_and_run.sh --verify

Use the verification flag when you want startup checks after the build.