Skip to main content
agtOS ships a native desktop application built with Tauri 2 that bundles the agtOS backend as a sidecar process. The desktop app provides a native experience on macOS, Linux, and Windows.

​
Features

System Tray

Health indicator in the system tray. Green when healthy, yellow for degraded, red for errors.

Global Hotkey

Push-to-talk hotkey (default: Alt+Space) works from any application. Configurable via settings.

Auto-Start

Optional auto-start on system login. The backend sidecar starts automatically.

Health Monitor

Monitors backend health and automatically restarts the sidecar if it crashes.

​
Architecture

The desktop app is a Tauri 2 shell that embeds the full agtOS backend: 
Tauri 2 (Rust + WebView)
    │
    ├── WebView: Dashboard UI (React 19)
    │
    └── Sidecar: agtOS Node.js backend (SEA binary)
            │
            ├── Port 3000: Voice WebSocket
            ├── Port 4100: MCP Server
            └── Port 4102: Health + REST API
The Node.js backend is compiled into a Single Executable Application (SEA) binary so users don’t need Node.js installed separately.

​
Installation

Download the desktop app from GitHub Releases:
PlatformFormatArchitecture
macOS.dmgApple Silicon (arm64) + Intel (x86_64)
Linux.AppImage, .debx86_64
Windows.msi, .exex86_64
The app includes a bundled Node.js backend compiled as a Single Executable Application — no separate Node.js installation required.

​
Configuration

The desktop app reads the same environment variables and config file as the CLI:
  • ~/.agtos/config.json — persistent configuration
  • AGTOS_PTT_HOTKEY — push-to-talk hotkey (default: Alt+Space)
  • AGTOS_NOTIFICATIONS_ENABLED — desktop notifications (default: false)
These can also be configured via the Settings page in the dashboard UI.

​
Push-to-Talk

The global PTT hotkey captures audio from the system microphone and streams it to the voice pipeline. It works from any application — you don’t need the agtOS window focused. 
# Configure the hotkey via environment variable
AGTOS_PTT_HOTKEY=Alt+Space

# Or via the Settings API
curl -X PUT http://localhost:4102/api/settings \
  -H "Content-Type: application/json" \
  -d '{"pttHotkey": "Ctrl+Shift+M"}'
The desktop app connects to the agtOS backend via localhost. It uses the same REST API, WebSocket, and MCP endpoints as the web dashboard and CLI.