{"id":50989120,"url":"https://github.com/XiaoLuoLYG/agent-beacon","last_synced_at":"2026-07-07T22:00:46.309Z","repository":{"id":362244426,"uuid":"1257209881","full_name":"XiaoLuoLYG/agent-beacon","owner":"XiaoLuoLYG","description":"A quiet macOS menu bar status light for local coding agent tasks.","archived":false,"fork":false,"pushed_at":"2026-06-03T08:16:33.000Z","size":28235,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-03T10:11:45.213Z","etag":null,"topics":["agent-tools","ai-agents","coding-agents","developer-tools","local-first","macos","macos-app","menu-bar","menubar-app","swift","swiftui"],"latest_commit_sha":null,"homepage":"https://github.com/XiaoLuoLYG/agent-beacon/releases/latest","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/XiaoLuoLYG.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-02T13:17:06.000Z","updated_at":"2026-06-03T08:16:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/XiaoLuoLYG/agent-beacon","commit_stats":null,"previous_names":["xiaoluolyg/agent-beacon"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/XiaoLuoLYG/agent-beacon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XiaoLuoLYG%2Fagent-beacon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XiaoLuoLYG%2Fagent-beacon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XiaoLuoLYG%2Fagent-beacon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XiaoLuoLYG%2Fagent-beacon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/XiaoLuoLYG","download_url":"https://codeload.github.com/XiaoLuoLYG/agent-beacon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XiaoLuoLYG%2Fagent-beacon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35243953,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-07T02:00:07.222Z","response_time":90,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-tools","ai-agents","coding-agents","developer-tools","local-first","macos","macos-app","menu-bar","menubar-app","swift","swiftui"],"created_at":"2026-06-20T00:00:28.870Z","updated_at":"2026-07-07T22:00:46.145Z","avatar_url":"https://github.com/XiaoLuoLYG.png","language":"Swift","funding_links":[],"categories":["AI Usage/Status"],"sub_categories":[],"readme":"# Agent Beacon\n\nTiny status lights for your coding agents. ✨\n\nAgent 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.\n\n![Agent Beacon demo](docs/assets/agent-beacon-demo.gif)\n\n## 🟢 Why It Exists\n\nWhen Codex, Claude Code, Cursor, Gemini CLI, and local scripts are all working at once, it is easy to lose track of what needs attention.\n\nAgent Beacon keeps that answer in one quiet menu bar panel:\n\n```text\ncompleted | needs review | failed | running\n```\n\nClick the menu bar icon to open the lights. Hover the panel to expand the task list.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/agent-beacon-hover-real.png\" alt=\"Agent Beacon expanded panel\" width=\"760\"\u003e\n\u003c/p\u003e\n\n## ⬇️ Install\n\nThe lowest-friction preview install is a one-line Terminal command:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/XiaoLuoLYG/agent-beacon/main/scripts/install-from-release.sh | bash\n```\n\nIt 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.\n\nThe 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.\n\nThe 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.\n\n## ⚡ What It Tracks\n\n- CLI-launched Codex, Claude Code, Cursor, Gemini CLI, and generic commands through local shims.\n- Codex local session metadata.\n- Cursor local composer header metadata.\n- Explicit status updates from `~/.agent-beacon/status.json`.\n\nMore agent integrations are in progress.\n\nAgent Beacon only shows states it can verify. It does not guess from private app UI.\n\n## 🔒 Local By Default\n\nAgent Beacon does not show conversation bodies, source files, terminal output, prompts, model responses, or logs.\n\nIt reads small local status records and metadata needed for task names, states, and jump targets.\n\n## Build From Source\n\n```bash\nmake test\nmake run\nmake package\n```\n\nMore docs:\n\n- [Install](docs/INSTALL.md)\n- [Quickstart](docs/QUICKSTART.md)\n- [Privacy](docs/PRIVACY.md)\n- [Roadmap](docs/ROADMAP.md)\n\nMIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FXiaoLuoLYG%2Fagent-beacon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FXiaoLuoLYG%2Fagent-beacon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FXiaoLuoLYG%2Fagent-beacon/lists"}