Skip to content
Lumicake edited this page Feb 28, 2026 · 3 revisions

Lumi Agent Wiki

Lumi Agent is a macOS-first AI agent platform. Agents can chat, call tools, and autonomously control your Mac. An iOS companion app pairs over Wi-Fi or USB for mobile chat and remote Mac control.

Pages

Page What it covers
Getting Started Install, first-run permissions, create your first agent
Architecture Layered design, AppState, repositories, data flow
Agents and Configuration Agent model, providers, security policy, capabilities
AI Providers OpenAI, Anthropic, Gemini, Qwen, Ollama — setup and differences
Tool Catalog All 60+ tools by category with risk levels
Desktop Control and Agent Mode Screen capture, mouse, keyboard, AppleScript
Hotkeys and Quick Actions Global hotkeys, command palette, quick-action panel, text assist
iOS Companion iOS app features, Bonjour pairing, USB detection, remote control, sync
Automation Trigger types, automation rules, background execution
Voice Whisper transcription, realtime VAD, TTS
Security and Permissions Risk levels, security policy, macOS entitlements, sandbox
Building and Deployment SPM build, app bundle, scripts, signing
Troubleshooting Common issues and fixes
Function Reference Auto-generated index of every function signature in the repo
Function Updates Function-level diff summary for current working-tree updates

Clone this wiki locally