Agent Signal Bar

Local status lights for AI agents on macOS.

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

Download for macOS View source

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

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

Works with the tools already running locally.

No dashboard account, no cloud relay, no hidden service.

Codex Desktop Tested & adapted

Local session log monitoring without required hooks.

Claude Code Not tested

Optional hook events for live agent state.

Local scripts Not tested

Write JSON events or wrap any command.

Agent CLI Not tested

Update, inspect, clear, and reset status from shell.

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

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.

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

Built for the menu bar, not another tab.

Choose detailed panels when you want context, or a simple native menu when you only need quick actions.

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

Open the latest GitHub Release.
Download AgentSignalLight-local.dmg.
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.