English | 简体中文

Physical workflow hardware for AI coding.

AhaKey is an open ecosystem built around official hardware, a shared BLE protocol, and community-built software for AI coding workflows.

We build the official hardware.
We open the software side.
The community can build clients, integrations, presets, and new workflows on top of AhaKey.

AhaKey is a physical control device designed for AI coding workflows.

It is built for tools and environments like:

• Claude
• Cursor
• Codex
• terminal-based AI coding workflows
• custom editing and command setups

AhaKey combines:

• physical keys
• mode switching
• BLE / USB connectivity
• OLED feedback
• RGB status feedback
• customizable client-side workflows

This is not just a keyboard.
It is a programmable workflow surface for AI-assisted coding.

We want to build a community around official hardware + shared BLE protocol + open software clients.

• desktop client software
• BLE protocol documentation
• client-side tools
• examples and integrations
• community workflows and presets

• firmware source
• hardware design source
• manufacturing files
• official device implementation details

Official hardware for stable experience.
Open software and protocol for community creativity.

Different users want very different things:

• different operating systems
• different editors and IDEs
• different AI coding tools
• different workflows
• different preferences for UI, shortcuts, and automation

The official client can guarantee a stable baseline,
but the community can make AhaKey much more diverse.

We welcome people to build:

• native clients for different platforms
• lighter or more specialized desktop tools
• integrations with Claude / Cursor / Codex workflows
• OLED / RGB editors
• custom key mapping tools
• workflow presets
• experimental clients and niche improvements

These repositories will grow over time.

• protocol — BLE protocol docs, device behavior, and examples
• desktop — official baseline desktop client
• firmware — official firmware-related releases and docs
• .github — community standards and templates
• awesome-ahakey — community projects, tools, demos, and workflows

If you are new here, start from:

1. protocol — understand how AhaKey communicates
2. desktop — try the official baseline client
3. Discussions — ask questions, share ideas, show your workflow
4. awesome-ahakey — explore community projects and experiments

We want AhaKey to become a place where people can:

• build their own clients
• improve existing tools
• create custom workflows
• share demos and presets
• experiment with AI coding interaction

We welcome:

• bug fixes

• protocol feedback

• client improvements

• platform adaptations

• workflow ideas

• showcase posts

• third-party tools

• Join Discussions for questions, ideas, integrations, and showcases

Some projects here are Officially Maintained.
Some are Community Maintained.

Official projects are the recommended baseline.
Community projects are where diversity, experimentation, and niche workflows can grow.

Being listed or showcased does not automatically mean official support or long-term maintenance.

If AhaKey fits your workflow, come build with us.

• Read the protocol
• Try the client
• Open an issue
• Start a discussion
• Join Discussions for questions, ideas, integrations, and showcases
• Build your own integration
• Share your setup and workflow

面向 AI 编程工作流的物理控制硬件。

AhaKey 是一个围绕 官方硬件、共享 BLE 协议 和社区软件生态建立的开放社区。

我们打造官方硬件。
我们开放软件端。
社区可以在 AhaKey 之上自由构建客户端、集成、preset 和新的工作流玩法。

AhaKey 是一个为 AI 编程工作流设计的物理控制设备。

它适用于这样的工具和环境：

• Claude
• Cursor
• Codex
• 基于终端的 AI coding workflow
• 自定义编辑与指令操作场景

AhaKey 提供：

• 实体按键
• 模式切换
• BLE / USB 连接
• OLED 状态显示
• RGB 状态反馈
• 可自定义的客户端工作流

它不只是一个普通键盘。
它更像一个面向 AI 辅助编程的可编程工作流控制面板。

我们希望围绕 官方硬件 + 共享 BLE 协议 + 开放软件客户端 建立社区生态。

• 桌面端客户端软件
• BLE 协议文档
• 客户端工具
• 示例与集成
• 社区 workflow 和 preset

• 固件源码
• 硬件设计源码
• 生产文件
• 官方设备实现细节

官方硬件提供稳定体验。
开放软件和协议释放社区创造力。

因为不同用户会有完全不同的需求：

• 不同操作系统
• 不同编辑器和 IDE
• 不同 AI coding 工具
• 不同工作流习惯
• 不同 UI、快捷键和自动化偏好

官方客户端可以提供稳定的基础体验，
但社区可以让 AhaKey 的生态更加多样。

我们欢迎大家围绕 AhaKey 去做：

• 不同平台的原生客户端
• 更轻量、更垂直的桌面工具
• Claude / Cursor / Codex 工作流集成
• OLED / RGB 编辑器
• 自定义按键映射工具
• workflow preset
• 面向细分场景的实验性客户端

这些仓库会随着社区发展逐步完善。

• protocol — BLE 协议文档、设备行为说明与示例
• desktop — 官方基础桌面客户端
• firmware — 官方固件相关发布与说明
• .github — 社区规范、模板和组织级配置
• awesome-ahakey — 社区项目、工具、演示与工作流收录

如果你第一次来到这里，建议从这些地方开始：

1. protocol — 先了解 AhaKey 如何通信
2. desktop — 体验官方基础客户端
3. Discussions — 提问、分享想法、展示你的 workflow
4. awesome-ahakey — 浏览社区项目和实验成果

我们希望 AhaKey 成为一个可以让大家：

• 开发自己的客户端
• 改进现有工具
• 创建自定义工作流
• 分享演示和 preset
• 探索 AI coding 交互方式

的开放社区。

我们欢迎：

• bug 修复

• 协议反馈

• 客户端改进

• 平台适配

• workflow 创意

• showcase 展示

• 第三方工具和集成

• 通过 Discussions 参与提问、想法讨论、集成交流和社区展示

这里未来会同时存在两类项目：

• Officially Maintained
• Community Maintained

官方维护项目代表默认推荐路径和基础稳定体验。
社区维护项目代表更丰富、多样、实验性或面向特定生态的扩展。

被收录、推荐或展示的社区项目，并不自动代表官方质量保证或长期维护承诺。

如果 AhaKey 适合你的工作流，欢迎一起来构建这个社区。

• 阅读协议
• 体验客户端
• 提交 issue
• 发起 discussion
• 通过 Discussions 参与提问、想法讨论、集成交流和社区展示
• 开发你的集成
• 分享你的 setup 和 workflow