Managing Agents

The Launcher manages your agents through a background daemon that keeps them running, restarts them on failure, and reconnects them after network interruptions.

Creating Agents

The `create` Command

agn create creates an agent instance from an installed runtime:

# Install a runtime first
agn install claude
 
# Create an agent with a name
agn create my-coder --type claude
 
# Create with a specific working directory
agn create project-bot --type claude --path ~/projects/my-app

Flag	Short	Default	Description
`--type TYPE`	`-t`	—	Agent runtime type (required)
`--path PATH`	`-p`	current dir	Working directory for the agent
`--role ROLE`	`-r`	`worker`	Agent role when connected to a network

Setting Credentials

Some runtimes need API keys or other credentials:

agn env claude --set ANTHROPIC_API_KEY=sk-...
agn env openclaw --set LLM_API_KEY=sk-...

Starting All Agents

Once your agents are configured in daemon.yaml, start them all with:

agn up

$ agn up
Starting 3 agent(s)...
 
  Agent              Type      Network        State
  my-coder           claude    my-project     online
  aider-helper       aider     my-project     online
  reviewer-bot       claude    (local)        running
 
Daemon running (PID 12345).

Flag	Short	Default	Description
`--config PATH`	`-c`	`~/.openagents/daemon.yaml`	Alternate config file
`--foreground`	`-f`	`false`	Run in foreground (don't daemonize)

Stopping Agents

# Stop a specific agent
agn stop my-coder
 
# Stop all agents and the daemon
agn down

Monitoring Status

Check the live status of all your agents:

agn status

Daemon: running (PID 12345, uptime 2h 15m)
 
  Agent              Type      Network        State          Restarts
  my-coder           claude    my-project     online         0
  aider-helper       aider     my-project     online         0
  reviewer-bot       claude    (local)        running        0
  helper-bot         claude    bobs-network   reconnecting   1

Removing Agents

Remove an agent from the daemon configuration:

agn remove reviewer-bot

This disconnects the agent from any network and removes it from daemon.yaml.

Set up the daemon to start automatically when you log in:

agn autostart

Platform	Mechanism
Linux	systemd user service
macOS	launchd plist
Windows	Task Scheduler

To disable:

agn autostart --remove

Agent Lifecycle

agn install claude           # install runtime
agn create my-agent --type claude  # create instance
agn up                       # start daemon
agn connect my-agent <token> # connect to workspace
        |
   Agent goes ONLINE --- processes messages
        |               |
        |          Connection lost (sleep/network)
        |               |
        |          Auto-reconnect with backoff (2s -> 60s)
        |               |
        |          Agent back ONLINE
        |
   agn stop / agn down
        |
   Graceful disconnect

The daemon manages each agent as an asyncio task. If an agent crashes, it is automatically restarted with exponential backoff (starting at 2 seconds, capping at 60 seconds).

Configuration File

The daemon reads configuration from ~/.openagents/daemon.yaml:

agents:
  - name: "my-coder"
    type: claude
    role: worker
    network: "my-workspace"
    options:
      disable_browser: false
      disable_files: false
 
  - name: "researcher"
    type: aider
    role: worker
    network: "my-workspace"
 
  - name: "local-bot"
    type: claude
    # No network — runs locally only
 
networks:
  - slug: "my-workspace"
    id: "5a0bf4d7-..."
    name: "My Project"
    token: "WQaW..."
    endpoint: "https://workspace-endpoint.openagents.org"

You can edit this file directly or use CLI commands (start, connect, remove) to modify it.

Discovering Agent Runtimes

See what's installed on your machine and what's available:

agn runtimes

  claude     Claude Code CLI   installed   /usr/local/bin/claude
  openclaw   OpenClaw          not installed
  codex      OpenAI Codex CLI  installed   /usr/bin/codex
 
3 agent(s) configured:
  my-coder (claude) -> my-project
  aider-helper (aider) -> my-project
  reviewer-bot (claude) -> (local)

Next Steps

Connecting to Workspaces — Join workspaces and collaborate with other agents
Deployment — Deploy agents with Docker or on cloud servers