https://github.com/XiaoLuoLYG/agent-beacon
A quiet macOS menu bar status light for local coding agent tasks.
https://github.com/XiaoLuoLYG/agent-beacon
agent-tools ai-agents coding-agents developer-tools local-first macos macos-app menu-bar menubar-app swift swiftui
Last synced: about 16 hours ago
JSON representation
A quiet macOS menu bar status light for local coding agent tasks.
- Host: GitHub
- URL: https://github.com/XiaoLuoLYG/agent-beacon
- Owner: XiaoLuoLYG
- License: mit
- Created: 2026-06-02T13:17:06.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-03T08:16:33.000Z (about 1 month ago)
- Last Synced: 2026-06-03T10:11:45.213Z (about 1 month ago)
- Topics: agent-tools, ai-agents, coding-agents, developer-tools, local-first, macos, macos-app, menu-bar, menubar-app, swift, swiftui
- Language: Swift
- Homepage: https://github.com/XiaoLuoLYG/agent-beacon/releases/latest
- Size: 26.9 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Support: SUPPORT.md
- Roadmap: docs/ROADMAP.md
Awesome Lists containing this project
- awesome-swift-macos-apps - Agent Beacon - beacon?style=flat&label=" /> <img align="bottom" height="13" src="https://img.shields.io/github/last-commit/XiaoLuoLYG/agent-beacon?style=flat&label=" /> - Tiny status lights for coding agents that show done, waiting, failed, or running tasks, with click-to-jump back to the source app. (AI Usage/Status)
README
# Agent Beacon
Tiny status lights for your coding agents. ✨
Agent Beacon lives in your macOS menu bar, shows which agent task is done, waiting, failed, or still running, and lets you click a row to jump back to the app.
## 🟢 Why It Exists
When Codex, Claude Code, Cursor, Gemini CLI, and local scripts are all working at once, it is easy to lose track of what needs attention.
Agent Beacon keeps that answer in one quiet menu bar panel:
```text
completed | needs review | failed | running
```
Click the menu bar icon to open the lights. Hover the panel to expand the task list.
## ⬇️ Install
The lowest-friction preview install is a one-line Terminal command:
```bash
curl -fsSL https://raw.githubusercontent.com/XiaoLuoLYG/agent-beacon/main/scripts/install-from-release.sh | bash
```
It downloads the latest release, installs `Agent Beacon.app` to `~/Applications`, installs the helper commands, connects supported agent CLIs, removes macOS quarantine from the installed app, and opens Agent Beacon.
The icon appears in the macOS menu bar. If you are in a full-screen app or your menu bar is hidden, move the pointer to the top edge of the screen or leave full screen first.
The DMG remains available on [Releases](https://github.com/XiaoLuoLYG/agent-beacon/releases), but unsigned DMG installs can trigger Gatekeeper's first-launch warning. Use the one-line installer for the preview build if you want the smoother path.
## ⚡ What It Tracks
- CLI-launched Codex, Claude Code, Cursor, Gemini CLI, and generic commands through local shims.
- Codex local session metadata.
- Cursor local composer header metadata.
- Explicit status updates from `~/.agent-beacon/status.json`.
More agent integrations are in progress.
Agent Beacon only shows states it can verify. It does not guess from private app UI.
## 🔒 Local By Default
Agent Beacon does not show conversation bodies, source files, terminal output, prompts, model responses, or logs.
It reads small local status records and metadata needed for task names, states, and jump targets.
## Build From Source
```bash
make test
make run
make package
```
More docs:
- [Install](docs/INSTALL.md)
- [Quickstart](docs/QUICKSTART.md)
- [Privacy](docs/PRIVACY.md)
- [Roadmap](docs/ROADMAP.md)
MIT License.