feat: add global shortcut to toggle panel (#132)

* feat: add global shortcut to toggle panel

* updated test cases

* feat(shortcuts): add tests, simplify UI, detect macOS accessibility permission

* remove accessibility permission layer

* fix: harden global shortcut update handling

Scope shortcut unregistration to the managed global shortcut instead of unregistering all, remove unused macOS deps left from accessibility work, and fix the broken README link formatting.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix: improve global shortcut unregistration logic

* fix: clear managed shortcut state after unregister

Keep managed global shortcut state synchronized with actual registration state by clearing the in-memory value immediately after a successful unregister, so retries can re-apply the same shortcut after a failed register.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Robin Ebers <robin.ebers@gmail.com>

Author: 3 people

README.md

@@ -1,4 +1,89 @@
-## Build from source
+**Track all your AI coding subscriptions in one place.**
+
+Amp, Cursor, Claude, Codex, and more coming. See your usage at a glance from your menu bar. No digging through dashboards.
+
+![OpenUsage Screenshot](screenshot.png)
+
+## Download
+
+[**Download the latest release**](https://github.com/robinebers/openusage/releases/latest) (macOS, Apple Silicon & Intel)
+
+The app auto-updates. Install once and you're set.
+
+## What It Does
+
+OpenUsage lives in your menu bar and shows you how much of your AI coding subscriptions you've used. Progress bars, badges, and clear labels. No mental math required.
+
+- **One glance.** All your AI tools, one panel.
+- **Always up-to-date.** Refreshes automatically on a schedule you pick.
+- **Global shortcut.** Toggle the panel from anywhere with a customizable keyboard shortcut.
+- **Lightweight.** Opens instantly, stays out of your way.
+- **Plugin-based.** New providers get added without updating the whole app.
+
+## Supported Providers
+
+- [**Amp**](docs/providers/amp.md) / free tier, bonus, credits
+- [**Antigravity**](docs/providers/antigravity.md) / all models
+- [**Claude**](docs/providers/claude.md) / session, weekly, extra usage
+- [**Codex**](docs/providers/codex.md) / session, weekly, reviews, credits
+- [**Copilot**](docs/providers/copilot.md) / premium, chat, completions
+- [**Cursor**](docs/providers/cursor.md) / credits, plan usage, on-demand
+- [**Kimi Code**](docs/providers/kimi.md) / session, weekly
+- [**Windsurf**](docs/providers/windsurf.md) / prompt credits, flex credits
+
+### Maybe Soon
+
+- [Factory / Droid](https://github.com/robinebers/openusage/issues/16)
+- [Gemini](https://github.com/robinebers/openusage/issues/13)
+- [Vercel AI Gateway](https://github.com/robinebers/openusage/issues/18)
+
+Community contributions welcome.
+Want a provider that's not listed? [Open an issue.](https://github.com/robinebers/openusage/issues/new)
+
+## Open Source, Community Driven
+
+OpenUsage is built by its users. Hundreds of people use it daily, and the project grows through community contributions: new providers, bug fixes, and ideas.
+
+I maintain the project as a guide and quality gatekeeper, but this is your app as much as mine. If something is missing or broken, the best way to get it fixed is to contribute by opening an issue, or submitting a PR.
+
+Plugins are currently bundled as we build our the API, but soon will be made flexible so you can build and load their own.
+
+**Windows/Linux:** high-priority and on the todo, but I need testers with some time, willing to help out.
+
+### How to Contribute
+
+- **Add a provider.** Each one is just a plugin. See the [Plugin API](docs/plugins/api.md).
+- **Fix a bug.** PRs welcome. Provide before/after screenshots.
+- **Request a feature.** [Open an issue](https://github.com/robinebers/openusage/issues/new) and make your case.
+
+Keep it simple. No feature creep, no AI-generated commit messages, test your changes.
+
+## Built Entirely with AI
+
+Not a single line of code in this project was read or written by hand. 100% AI-generated, AI-reviewed, AI-shipped — using [Cursor](https://cursor.com), [Claude Code](https://docs.anthropic.com/en/docs/claude-code), and [Codex CLI](https://github.com/openai/codex).
+
+OpenUsage is a real-world example of what I teach in the [AI Builder's Blueprint](https://itsbyrob.in/EBDqgJ6) — a proven process for building and shipping software with AI, no coding background required.
+
+## Sponsors
+
+OpenUsage is supported by our sponsors. Become a sponsor to get your logo here and on [openusage.ai](https://openusage.ai).
+
+[Become a Sponsor](https://github.com/sponsors/robinebers)
+
+<!-- Add sponsor logos here -->
+
+## Credits
+
+Inspired by [CodexBar](https://github.com/steipete/CodexBar) by [@steipete](https://github.com/steipete). Same idea, very different approach.
+
+## License
+
+[MIT](LICENSE)
+
+---
+
+<details>
+<summary><strong>Build from source</strong></summary>
 
 > **Warning**: The `main` branch may not be stable. It is merged directly without staging, so users are advised to use tagged versions for stable builds. Tagged versions are fully tested while `main` may contain unreleased features.
 

bun.lock

@@ -27,6 +27,7 @@
     "@tauri-apps/plugin-process": "^2.3.1",
     "@tauri-apps/plugin-store": "^2.4.2",
     "@tauri-apps/plugin-updater": "^2.10.0",
+    "@tauri-apps/plugin-global-shortcut": "^2",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.563.0",

package.json

@@ -35,6 +35,7 @@ tauri-plugin-log = "2"
 tauri-plugin-aptabase = { git = "https://github.com/aptabase/tauri-plugin-aptabase", rev = "e896cceb" }
 tauri-plugin-updater = "2"
 tauri-plugin-process = "2"
+tauri-plugin-global-shortcut = "2"
 tokio = { version = "1", features = ["rt-multi-thread", "macros"] }
 regex-lite = "0.1.9"
 

src-tauri/Cargo.lock

@@ -15,6 +15,7 @@
     "store:default",
     "aptabase:allow-track-event",
     "updater:default",
-    "process:allow-restart"
+    "process:allow-restart",
+    "global-shortcut:default"
   ]
 }