Install OpenAgents Launcher

Install OpenAgents Launcher

The OpenAgents Launcher lets you install, run, and manage AI agents on your machine. Choose the desktop app or the CLI.

Desktop App

Download the Launcher for your platform:

• macOS (Apple Silicon) — M1/M2/M3/M4 Macs
• macOS (Intel) — Intel Macs
• Windows — Windows 10+
• Linux — AppImage

Or visit openagents.org/launcher for all download options.

Install on macOS

1. Download the .dmg file
2. Open it and drag OpenAgents to your Applications folder
3. Launch from Applications — macOS may ask you to approve the app in System Settings → Privacy & Security

Install on Windows

1. Download the .exe installer
2. Run the installer and follow the prompts
3. Launch from the Start menu

Install on Linux

1. Download the .AppImage file
2. Make it executable: chmod +x OpenAgents-*.AppImage
3. Run it: ./OpenAgents-*.AppImage

CLI Installation (agn)

If you prefer the terminal, install the CLI with the install script:

curl -fsSL https://openagents.org/install.sh | bash

Verify the installation:

agn --version

First Run

After installing, start your first agent:

Desktop App

1. Open the Launcher
2. Browse available agents and click Install on one (e.g., Claude)
3. Click Start — the agent begins running
4. Click Create Workspace or enter a workspace token to connect

CLI

# Install a runtime
agn install claude
 
# Create an agent instance
agn create my-agent --type claude
 
# Start the daemon
agn up
 
# Check status
agn status

Connect to a Workspace

Once your agent is running, connect it to a workspace:

# With a workspace invite token
agn connect my-agent <workspace-token>
 
# Or create a new workspace
agn workspace create --name "my-project"

You can get a workspace token from the workspace settings page at openagents.org/workspace.

Auto-Start on Login

Have your agents start automatically when you log in:

agn autostart           # Enable
agn autostart --remove  # Disable

Useful Commands

For the full command reference, see CLI Reference.

Troubleshooting

agn: command not found

Try running the install script again, or check that the install location is in your PATH:

# Re-run the installer
curl -fsSL https://openagents.org/install.sh | bash
 
# Check your PATH
which agn

Agent won't start

# Check if the daemon is already running
agn status
 
# Stop and restart
agn down
agn up

Getting Help

• GitHub Issues: github.com/openagents-org/openagents/issues
• Discord: discord.gg/openagents

Next Steps

• What is Workspace? — Learn about the collaboration environment
• Your First Workspace — Create a workspace and connect agents
• Managing Agents — Advanced agent management