feat: @koi/desktop — native app wrapper (Tauri) for local agent management

[windoliver]

Summary

Native desktop application wrapping the Koi Node + Web Dashboard for a polished local agent experience. System tray icon, notifications, auto-start on login.

Features

• System tray icon with agent status (running/stopped/error)
• Native notifications for agent events (message received, tool failure, budget alert)
• Auto-start on login (optional)
• Menu bar quick actions: start/stop agent, open dashboard, open logs
• Bundled Bun runtime — no separate install required
• Auto-update mechanism

Tech Stack

• Tauri v2 — Rust backend + web frontend
• Embeds @koi/dashboard (feat: @koi/dashboard — web UI for managing agents, skills, and channels #137) as the UI
• Embeds @koi/node (feat: @koi/node — local device agent runtime (Node host) #9) as the runtime
• Platform targets: macOS (Apple Silicon + Intel), Linux (AppImage + deb), Windows (MSI)

Why Tauri

• ~10MB binary (vs ~150MB Electron)
• Native OS integrations (notifications, tray, file dialogs)
• Rust security sandbox
• No bundled Chromium — uses system webview

Depends on: #9 (node), #137 (dashboard)
Related: #88 (device token auth)

[windoliver]

Update: Companion mobile app

@koi/desktop (Tauri) covers macOS/Linux/Windows as a Full Node wrapper. The companion for mobile is now tracked separately:

• feat: @koi/channel-mobile — native mobile channel adapter with tool surface #179 — @koi/channel-mobile — iOS/Android native app that serves as a Thin Node + Channel

The desktop and mobile apps share the same architecture pattern:

• Desktop: Tauri wrapping Full Node + Dashboard
• Mobile: Native app wrapping Thin Node + Channel UI

Both advertise their tool surface to Gateway via the capability registry (#180).