OpenAgentsDocumentation
Login
LauncherLauncher Installation & Setup
Updated August 22, 2026

Launcher Installation & Setup

Download and install OpenAgents Launcher on macOS, Windows, or Linux, and get your first agent running — click by click.

Launcher Installation & Setup

Grab the app from the download page — it always serves the latest release.

macOS

  1. On the download page, click macOS and pick your chip: Apple Silicon (M-series Macs) or Intel. Not sure? Apple menu → About This Mac.
  2. Open the downloaded .dmg and drag OpenAgents Launcher into Applications.
  3. Launch it from Applications.

Windows

  1. Click Windows on the download page to get the installer (.exe).
  2. Run it.
  3. If Windows SmartScreen shows a warning: the app isn't code-signed yet, so SmartScreen may object. Click More info → Run anyway to proceed.

Linux

Click All platforms on the download page to open the releases list, then pick:

  • .deb for Debian/Ubuntu: sudo dpkg -i OpenAgents-Launcher-<version>-linux-amd64.deb
  • .AppImage for anything else: make it executable (chmod +x) and run it.

First run — the setup wizard

The first launch opens a guided onboarding flow. On the Welcome screen it checks your machine (Node.js, npm, agent core, credential store) and asks you to choose a path:

1
Path 1 — Connect this device (recommended if you already have a workspace)

Paste the 8-character pairing code from your workspace's Connect Agent → Nodes panel. Your machine joins the workspace as a node, and you can finish setting up agents from the workspace in the browser.

2
Path 2 — Set up an agent here

The wizard walks you through it: pick your first agent from the gallery (Claude Code is a great first choice) → configure keys (paste an API key or use account sign-in, then Test connection) → create your agent (name + working folder) → optionally connect a workspace.

Launcher — first-run onboarding
Screenshot: Launcher onboarding welcome screen with the two paths
First run: connect this device with a pairing code, or set up your first agent locally.

Either way you land on the Dashboard with a short guided tour of the three steps: Marketplace (install agents) → Agents (create & test) → Workspaces (open and manage).

From here, connect to a workspace so you can talk to your agents from the browser: Connecting to Workspaces.

Updates

The Launcher updates itself automatically, and it keeps your installed agents up to date too — one less thing to maintain.

Prefer the terminal?

Everything above can also be done with the agn CLI:

# macOS / Linux
curl -fsSL https://openagents.org/install.sh | bash
 
# Windows (PowerShell)
irm https://openagents.org/install.ps1 | iex

See the CLI Reference for commands — but if you're happy in the app, you never need the terminal.