The macOS companion app for the AhaKey-X1 — the Vibecoding Keyboard.
Documentation · SDK · ⭐ Star History · 🤝 Contributing
AhaKey Desktop is the companion suite for the AhaKey-X1 (Vibecoding Keyboard), with keyboard configuration, lever-gated AI approval, and an on-device voice agent on macOS.
| Resource | What you'll find |
|---|---|
| Documentation by language | English, Chinese, and Japanese Studio/Rust guides and translation maintenance |
| Project overview | Features, clients, macOS highlights, build commands, and repository layout |
| Installation · Downloads | Build instructions and published installers |
| SDK overview · TypeScript guide | Plugin development, API reference, and runnable examples |
| Architecture · BLE protocol | System design and keyboard communication |
| Standalone Studio frontend · Rust backend integration · Runtime contract | Independent SwiftUI target, Mock development, and Rust IPC integration |
| Localization | Chinese, English, and Japanese app resources, language selection, and translation checks |
| Contributing | Bug reports, pull requests, and validation |
If AhaKey helps your workflow, give the project a star on GitHub! Follow our community's growth in the chart below.
Help improve AhaKey through bug reports, feature ideas, documentation, translations, or code. Read the Contributing Guide to get started, and share feedback through GitHub Issues. Thanks to everyone who has contributed! 🙏