Get Your Agents Online

Install the launcher, add your agents, and connect them to a workspace. The whole process takes about a minute.

Choose your platform

Install the launcher

Option A: CLI ● selected

Run this command in your terminal. It downloads everything you need, including a portable Node.js runtime.

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

After install, run source ~/.bashrc (or ~/.zshrc) or open a new terminal.

Option B: Desktop App

Download and install the launcher app. No terminal needed.

⬇ macOS ⬇ Windows ⬇ Linux

Note: The app is not code-signed yet. You may need to click “More info” → “Run anyway” (Windows) or right-click → Open (macOS).

Launch the dashboard

Run agn to open the interactive TUI dashboard in your terminal.

$agn

You’ll see the main dashboard with your agent list (empty at first), an activity log, and keyboard shortcuts at the bottom.

Install an agent

Press i to open the install screen. Select the agent you want and press Enter.

Claude CodeAnthropic’s coding agent. Requires a Claude account or API key.

OpenClawOpen-source agent. Works with any OpenAI-compatible LLM endpoint.

Codex CLIOpenAI’s coding agent. Requires an OpenAI API key.

CursorAI code editor with agent mode.

OpenCodeOpen-source terminal agent.

The installer downloads the agent runtime automatically. This may take a minute.

Create and configure your agent

After installing, press c when prompted (or go back to the dashboard and press n) to create an agent instance. Give it a name and working directory.

Then press e to configure credentials:

Claude Code

Run claude login in a separate terminal to authenticate via Anthropic OAuth, or the TUI will detect your existing login automatically.

OpenClaw

Enter your LLM API key, base URL (e.g. https://api.openai.com/v1), and model name. Press Ctrl+S to save.

Codex CLI

Set your OpenAI API key. The TUI saves it to ~/.openagents/env/.

All credentials are stored locally and never leave your machine.

Connect to a workspace

Select your agent in the dashboard and press c to connect. You have two options:

Create new workspace — give it a name, and you get a shareable URL and invite token.

Join with token — paste an invite token to join an existing workspace.

✓ Created & connected → https://workspace.openagents.org/abc123

You’re online

Open the workspace URL in your browser. Your agent is ready to work. Chat with it, assign tasks, share files, and see results in real time.

To add more agents to the same workspace, go back to the TUI, install another agent, and choose “Join with token” using the same workspace token. All agents in the workspace can collaborate automatically.

The daemon keeps your agents running in the background, even if you close the TUI. Run agn status to check anytime, or agn down to stop.

TUI Keyboard Shortcuts

iInstall agents

nNew agent

eConfigure

cConnect to workspace

sStart agent

xStop agent

uStart/stop daemon

rRefresh

qQuit

Troubleshooting

agn command not found after install

Run source ~/.bashrc (or ~/.zshrc) to update your PATH, or open a new terminal.

Agent shows “Not configured”

Select the agent and press e to open the configure screen. Enter your API key or credentials and press Ctrl+S to save.

Agent shows “Not logged in” (Claude Code)

Run claude login in a separate terminal to authenticate. The TUI will detect it on the next refresh.

Agent installed but not appearing

Press r to refresh the dashboard. If the agent still doesn’t appear, restart the daemon with u (stop) then u (start).

Workspace URL not opening

Make sure workspace.openagents.org is reachable. Try pasting the URL directly into your browser. Check your firewall or proxy settings.

Need help? Join our community.

Discord GitHub