Desktop App
The easiest way to use Groove — no terminal, no dependencies, no setup.
Download the desktop app, open a project folder, and start spawning agents. The daemon, GUI, and auto-updates are all bundled. Works on macOS, Windows, and Linux.
Download
All downloads are from the latest GitHub release.
| Platform | Architecture | Download |
|---|---|---|
| macOS | Apple Silicon (M1+) | Download .dmg |
| macOS | Intel | Download .dmg |
| Windows | x64 | Download .exe |
| Windows | ARM64 | Download .exe |
| Linux | x64 | Download .AppImage |
| Linux | ARM64 | Download .AppImage |
Features
- Bundled daemon — the Groove daemon starts automatically when you open a project. No terminal, no
groove start. - Full GUI dashboard — the same VS Code-style interface with agent tree, editor, dashboard, marketplace, and teams.
- System tray — quick access to recent projects, agent status, and daemon controls from your menu bar or taskbar.
- Automatic updates — silent background updates keep you on the latest version without any manual steps.
- Multi-workspace — open multiple project folders. Each gets its own daemon instance with isolated agent state.
- No Node.js or terminal needed — everything is bundled. Download, install, open a folder.
How It Works
- Download the installer for your platform from the table above
- Install — drag to Applications (macOS), run the installer (Windows), or make the AppImage executable (Linux)
- Open a project folder — the app prompts you to select a directory
- Daemon starts — the bundled daemon launches automatically for that project
- GUI loads — the full dashboard appears with the agent tree, spawn wizard, and all views
- Spawn agents — click Spawn Agent, pick a role, provider, and model, and start building
That's it. No terminal commands, no npm, no Node.js installation.
vs Developer Install
The desktop app and the terminal install (npm i -g groove-dev) provide the same functionality. The desktop app just bundles everything into a native application.
| Desktop App | Developer Install | |
|---|---|---|
| Setup | Download and open | npm i -g groove-dev + groove start |
| Node.js required | No | Yes (v20+) |
| CLI access | No | Yes (groove commands) |
| GUI | Built-in | Browser at localhost:31415 |
| Auto-updates | Yes | npm update -g groove-dev |
| VPS deployment | No | Yes |
| System tray | Yes | No |
| Multi-workspace | Yes (one daemon per folder) | Manual (one daemon at a time) |
Use the desktop app if you want the simplest experience — download, open, spawn agents.
Use the developer install if you want CLI access, VPS deployment, or need to integrate Groove into your existing terminal workflow.
System Requirements
| Platform | Minimum Version | Notes |
|---|---|---|
| macOS | 11 (Big Sur)+ | Intel and Apple Silicon |
| Windows | 10+ | x64 and ARM64 |
| Linux | Any with FUSE support | Required for AppImage. Most modern distros include it. |
No other dependencies are required. The desktop app bundles its own Node.js runtime and daemon.