CLI Commands

Setup

duragent init

Initialize a new Duragent workspace.

duragent init [path] [flags]

Flags:
      --agent-name string   Name for the starter agent
      --provider string     LLM provider (anthropic, openrouter, openai, ollama)
      --model string        Model name
      --no-interactive      Skip interactive prompts; use defaults

Example:

duragent init
duragent init --agent-name my-bot --provider anthropic

duragent login

Authenticate with an LLM provider via OAuth. Currently only anthropic is supported.

Credentials are stored at ~/.duragent/auth.json (mode 0600) and take precedence over the corresponding environment variable (e.g. ANTHROPIC_API_KEY). Tokens are automatically refreshed when they expire.

duragent login <provider>

Example:

duragent login anthropic

Server

duragent serve

Start the Duragent server.

duragent serve [flags]

Flags:
      --host string           Host to bind to (overrides config)
  -p, --port int              HTTP port (overrides config)
      --agents-dir string     Path to agents directory (overrides config)
  -c, --config string         Path to config file (default duragent.yaml)
      --ephemeral <SECONDS>   Auto-shutdown after N seconds with no active sessions

Example:

duragent serve
duragent serve --port 9090

duragent serve stop

Stop a running server.

duragent serve stop

duragent serve reload-agents

Reload agent configurations from disk without restarting the server.

duragent serve reload-agents

Sessions

duragent chat

Start an interactive chat session with an agent.

duragent chat [flags]

Flags:
  -a, --agent string      Agent name (required)
      --agents-dir string  Path to agents directory (overrides config)
  -c, --config string     Path to config file (default duragent.yaml)
  -s, --server string     Connect to a specific server URL

Examples:

duragent chat --agent my-assistant

Interactive Commands

Within duragent chat, these commands are available:

duragent attach

Attach to an existing session (like tmux attach).

duragent attach [SESSION_ID] [flags]

Flags:
  -l, --list              List all attachable sessions
      --agents-dir string  Path to agents directory (overrides config)
  -c, --config string     Path to config file (default duragent.yaml)
  -s, --server string     Connect to a specific server URL

Examples:

duragent attach --list
duragent attach SESSION_ID

When attaching to a session with on_disconnect: continue, you’ll see any output that was buffered while you were away.

Maintenance

duragent doctor

Diagnose installation and configuration issues. Checks config files, agents, gateways, provider credentials, and security settings.

duragent doctor [flags]

Flags:
  -c, --config string     Path to config file (default duragent.yaml)
      --format string     Output format: text or json (default text)

Examples:

duragent doctor
duragent doctor --format json

duragent upgrade

Upgrade duragent to the latest version (or a specific version) by downloading the platform binary from GitHub Releases. Verifies checksums when available and replaces the binary atomically.

duragent upgrade [flags]

Flags:
      --check             Only check for updates, don't install
      --version string    Target version (e.g., "0.6.0" or "v0.6.0")
      --restart           Restart a running server after upgrade
  -c, --config string     Path to config file (default duragent.yaml, used with --restart)
  -p, --port int          Port override (used with --restart)
      --format string     Output format: text or json (default text)

Examples:

duragent upgrade --check
duragent upgrade
duragent upgrade --version 0.4.0
duragent upgrade --restart
duragent upgrade --format json

With --restart, the command shuts down the running server gracefully, then execs the new binary with the same serve arguments. Sessions are flushed to disk before shutdown and recovered on startup.