How ahakeyai/desktop works
AhaKey Desktop is a cross-platform companion suite for the AhaKey-X1 keyboard, with configuration, AI approval hooks, and voice features. The main workflow configures keyboard behavior and routes device events through a desktop client; macOS and Windows also have distinct agent and speech paths. The graph includes the documented plugin capability and sampled native-client components. Many modules are represented from the tree or README rather than inspected source; their connections are omitted unless documented or evidenced by the source index.
Main entry points: backend.rs Command backend · main.rs Application runtime · device_routing.rs Device routing · state.rs Runtime state
Components 29
Native Studio
- Studio interface
ahakey-studio-tauri/src/main.tsx - Application runtime
ahakey-studio-tauri/src-tauri/src/main.rs - Command backend
ahakey-studio-tauri/src-tauri/src/backend.rs - Runtime state
ahakey-studio-tauri/src-tauri/src/state.rs - Device operations
ahakey-studio-tauri/src-tauri/src/device.rs - Device routing
ahakey-studio-tauri/src-tauri/src/device_routing.rs - BLE protocol
ahakey-studio-tauri/crates/ble/src/protocol.rs - BLE routing
ahakey-studio-tauri/crates/ble/src/routing.rs - USB routing
ahakey-studio-tauri/crates/ble/src/usb_routing.rs - Voice capture
ahakey-studio-tauri/src-tauri/src/voice.rs - Speech engine
ahakey-studio-tauri/crates/speech/src/lib.rs - Cloud sessions
ahakey-studio-tauri/crates/cloud/src/session.rs - Approval hooks
ahakey-studio-tauri/src-tauri/src/hooks.rs - Settings
ahakey-studio-tauri/src-tauri/src/settings.rs - BLE recovery
ahakey-studio-tauri/src-tauri/src/recovery.rs - Platform services
ahakey-studio-tauri/src-tauri/src/platform.rs
macOS Companion
- Mac configuration UI
ahakeyconfig-mac/Sources/Views/AhaKeyStudioView.swift - Mac BLE manager
ahakeyconfig-mac/Sources/BLE/AhaKeyBLEManager.swift - AI approval agent
ahakeyconfig-mac/Sources/Utilities/AgentManager.swift - Mac plugin manager
ahakeyconfig-mac/Sources/AhaKeyPluginKit/PluginManager.swift
Windows Companion
- Windows settings UI
ahakeyconfig-win-python/src/ui/main_window.py - Windows device service
ahakeyconfig-win-python/src/comm/device_service.py - Capswriter client
ahakeyconfig-win-python/Capswriter-master/Capswriter-master/core_client.py - Local speech engine
ahakeyconfig-win-python/Capswriter-master/Capswriter-master/util/fun_asr_gguf/asr_engine.py - Text assistant
ahakeyconfig-win-python/Capswriter-master/Capswriter-master/util/llm/llm_handler.py - Hotword manager
ahakeyconfig-win-python/Capswriter-master/Capswriter-master/util/hotword/manager.py
Plugin SDK
- TypeScript SDK
sdks/typescript/src/index.ts
Other components
- Keyboard user
- Plugin developer
Connections 21
- Keyboard user → Studio interface: configures
README.md - Studio interface → Application runtime: invokes commands
ahakey-studio-tauri/src/main.tsx - Application runtime → Command backend: registers commands
ahakey-studio-tauri/src-tauri/src/main.rs - Application runtime → Runtime state: initializes state
ahakey-studio-tauri/src-tauri/src/main.rs - Command backend → Runtime state: uses state
ahakey-studio-tauri/src-tauri/src/backend.rs - Device routing → Command backend: references
ahakey-studio-tauri/src-tauri/src/device_routing.rs - Device routing → Runtime state: uses state
ahakey-studio-tauri/src-tauri/src/device_routing.rs - Application runtime → Device routing: registers commands
ahakey-studio-tauri/src-tauri/src/main.rs - Command backend → BLE routing: uses BLE
- Command backend → USB routing: uses USB
- Command backend → Device operations: uses device
ahakey-studio-tauri/src-tauri/src/backend.rs - BLE routing → BLE protocol: uses protocol
ahakey-studio-tauri/crates/ble/src/routing.rs - Keyboard user → Mac configuration UI: configures
README.md - AI approval agent → Mac BLE manager: coordinates access
ahakeyconfig-mac/Sources/Utilities/AgentManager.swift - Mac configuration UI → Mac BLE manager: uses BLE
- Keyboard user → Windows settings UI: configures
README.md - Windows settings UI → Windows device service: uses device service
- Capswriter client → Local speech engine: uses speech engine
- Text assistant → Hotword manager: gets hotwords
ahakeyconfig-win-python/Capswriter-master/Capswriter-master/util/llm/llm_handler.py - Plugin developer → TypeScript SDK: develops plugins
README.md - Mac plugin manager → TypeScript SDK: uses SDK