{"id":50548465,"url":"https://github.com/dgpisces/bough","last_synced_at":"2026-06-04T01:00:40.178Z","repository":{"id":362149064,"uuid":"1234412333","full_name":"DGPisces/bough","owner":"DGPisces","description":"A macOS notch companion for AI coding agents.","archived":false,"fork":false,"pushed_at":"2026-06-02T21:51:02.000Z","size":3843,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-02T23:08:17.972Z","etag":null,"topics":["ai-tools","macos","notch","sparkle","swift","swiftui"],"latest_commit_sha":null,"homepage":"","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/DGPisces.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"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-05-10T06:34:35.000Z","updated_at":"2026-06-02T21:51:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/DGPisces/bough","commit_stats":null,"previous_names":["dgpisces/bough"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/DGPisces/bough","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DGPisces%2Fbough","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DGPisces%2Fbough/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DGPisces%2Fbough/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DGPisces%2Fbough/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DGPisces","download_url":"https://codeload.github.com/DGPisces/bough/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DGPisces%2Fbough/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33886153,"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-06-03T02:00:06.370Z","response_time":59,"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":["ai-tools","macos","notch","sparkle","swift","swiftui"],"created_at":"2026-06-04T01:00:25.097Z","updated_at":"2026-06-04T01:00:40.153Z","avatar_url":"https://github.com/DGPisces.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"Assets/Brand/logo.png\" alt=\"Bough\" width=\"240\"/\u003e\n\u003c/p\u003e\n\n# Bough\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"README.zh-CN.md\"\u003e简体中文\u003c/a\u003e\n\u003c/p\u003e\n\nBough is a macOS notch utility that keeps AI coding agents, usage, music, lyrics, and AirDrop state visible at the top of your screen.\n\n![Bough notch panel demo](Assets/README/panel-session-music-airdrop.png)\n\n## Features\n\n- Shows session state for Codex, Claude Code, Cursor, and other supported tools in the notch area.\n- Surfaces permission requests, questions, completion, busy, and idle states, with jump-back support to the matching terminal or app.\n- Tracks AI usage windows with optional usage and recovery notifications.\n- Displays music playback, lyrics, and AirDrop drag surfaces.\n- Supports local, remote SSH, and common terminal/editor workflows.\n- Includes the Bough mascot, tool mascots, pixel sounds, diagnostics, and Settings previews.\n\n\u003cdetails\u003e\n\u003csummary\u003eSupported tools\u003c/summary\u003e\n\n| Tool | Bough mascot |\n|---|---|\n| Codex | \u003cimg src=\"Assets/README/mascots/codex.gif\" alt=\"Codex mascot\" width=\"56\"/\u003e |\n| Claude Code | \u003cimg src=\"Assets/README/mascots/claude.gif\" alt=\"Claude Code mascot\" width=\"56\"/\u003e |\n| Cursor | \u003cimg src=\"Assets/README/mascots/cursor.gif\" alt=\"Cursor mascot\" width=\"56\"/\u003e |\n| GitHub Copilot | \u003cimg src=\"Assets/README/mascots/copilot.gif\" alt=\"GitHub Copilot mascot\" width=\"56\"/\u003e |\n| Gemini CLI | \u003cimg src=\"Assets/README/mascots/gemini.gif\" alt=\"Gemini CLI mascot\" width=\"56\"/\u003e |\n| OpenCode | \u003cimg src=\"Assets/README/mascots/opencode.gif\" alt=\"OpenCode mascot\" width=\"56\"/\u003e |\n| Qwen Code | \u003cimg src=\"Assets/README/mascots/qwen.gif\" alt=\"Qwen Code mascot\" width=\"56\"/\u003e |\n| Kimi | \u003cimg src=\"Assets/README/mascots/kimi.gif\" alt=\"Kimi mascot\" width=\"56\"/\u003e |\n| Trae | \u003cimg src=\"Assets/README/mascots/trae.gif\" alt=\"Trae mascot\" width=\"56\"/\u003e |\n| Qoder | \u003cimg src=\"Assets/README/mascots/qoder.gif\" alt=\"Qoder mascot\" width=\"56\"/\u003e |\n| Antigravity | \u003cimg src=\"Assets/README/mascots/antigravity.gif\" alt=\"Antigravity mascot\" width=\"56\"/\u003e |\n| CodeBuddy | \u003cimg src=\"Assets/README/mascots/codebuddy.gif\" alt=\"CodeBuddy mascot\" width=\"56\"/\u003e |\n| WorkBuddy | \u003cimg src=\"Assets/README/mascots/workbuddy.gif\" alt=\"WorkBuddy mascot\" width=\"56\"/\u003e |\n| Droid | \u003cimg src=\"Assets/README/mascots/droid.gif\" alt=\"Droid mascot\" width=\"56\"/\u003e |\n| Hermes | \u003cimg src=\"Assets/README/mascots/hermes.gif\" alt=\"Hermes mascot\" width=\"56\"/\u003e |\n| StepFun | \u003cimg src=\"Assets/README/mascots/stepfun.gif\" alt=\"StepFun mascot\" width=\"56\"/\u003e |\n\n\u003c/details\u003e\n\n## Install\n\nThe current stable release is `v1.0.0`.\n\n1. Open [GitHub Releases](https://github.com/DGPisces/bough/releases).\n2. Download the latest `Bough.dmg`.\n3. Open the DMG and drag `Bough.app` into `/Applications`.\n4. On first launch, follow macOS prompts for opening the app and granting required permissions.\n\n## Automatic Updates\n\nBough uses the public repository stable channel for automatic updates. Stable builds check the public update feed for signed in-app updates.\n\n## Build From Source\n\nRequires macOS 14+, Swift 5.9+, and Xcode Command Line Tools.\n\n```sh\nswift package resolve\nswift build -c release\nswift test\n```\n\nThe release executable is `.build/release/Bough`.\n\n## Contributing\n\nSee [`CONTRIBUTING.md`](CONTRIBUTING.md). Report security issues through GitHub private vulnerability reporting.\n\n## Thanks\n\nThanks to [CodeIsland](https://github.com/wxtsky/CodeIsland) for providing the foundation. See [`CREDITS.md`](CREDITS.md) for license and third-party notices.\n\n## License\n\nBough is released under the MIT License. See [`LICENSE`](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdgpisces%2Fbough","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdgpisces%2Fbough","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdgpisces%2Fbough/lists"}