doctl harness-runtime

Generated on 23 Sep 2026 from doctl version v1.173.0

Usage

doctl harness-runtime [flags]

Aliases

agent, agents, ohr

Description

Managed Agents Runtime Services (M.A.R.S) — run a coding agent (Claude Code, OpenCode, Codex, …) in a DigitalOcean sandbox.

Currently in public preview. Public Preview Terms.

Two verbs cover the lifecycle, split on whether you want to watch:

  • launch puts you in a session — creating it first if you gave it something to create from, or attaching to one you already have.
  • create makes a session and leaves it alone, for scripts and agents.

Create a session and land in the chat:

doctl harness-runtime launch \
  --harness claude-code \
  --gh-repo owner/repo \
  --prompt "Review the README"

Or create without attaching, then open it later:

doctl harness-runtime create \
  --harness claude-code \
  --gh-repo owner/repo \
  --prompt "Review the README"
doctl harness-runtime launch my-session

Session commands accept a session ID or an exact unique name.

Renamed in recent betas. open-harness-runtime is now harness-runtime (also agent, agents, ohr). start / run are now create (both still work). attach is now launch (also up / chat / attach; interactive only — scripts should use create). destroy is now remove (still accepted as destroy / rm).

Flags

Option Description
--help, -h Help for this command
Command Description
doctl doctl is a command line interface (CLI) for the DigitalOcean API.
doctl harness-runtime approve Resolve a pending HITL request out of band
doctl harness-runtime auth Connect an external provider (e.g. github) for agent git operations
doctl harness-runtime balance Show your team's prepayment balance and gate status
doctl harness-runtime checkpoint Manage session checkpoints (save points)
doctl harness-runtime config Manage reusable agent configs
doctl harness-runtime create Create a session without attaching
doctl harness-runtime download Download a file from a session workspace
doctl harness-runtime exec Run a command in a session's sandbox
doctl harness-runtime files Browse and read a session workspace
doctl harness-runtime fork Fork a session into independent child sessions
doctl harness-runtime launch Open a session, creating it first if needed
doctl harness-runtime list List your sessions
doctl harness-runtime logs Replay the event history for a session
doctl harness-runtime pause Pause a session
doctl harness-runtime port-forward Forward local TCP ports into the session's sandbox
doctl harness-runtime prompt Send one prompt to a session and print the answer
doctl harness-runtime remove Remove a session
doctl harness-runtime resume Resume a paused session
doctl harness-runtime rollback Roll a session back to a checkpoint in place
doctl harness-runtime show Show one session
doctl harness-runtime sizes List available sandbox sizes
doctl harness-runtime start-proxy Bridge the Codex CLI to a hosted session
doctl harness-runtime template Manage team custom sandbox templates
doctl harness-runtime triggers Manage webhook and cron triggers for hosted agent runs
doctl harness-runtime update Update settings on an existing session
doctl harness-runtime upload Upload a file into a session workspace
doctl harness-runtime validate Validate an agent manifest

Global Flags

Option Description
--access-token, -t API V2 access token
--api-url, -u Override default API endpoint
--config, -c Specify a custom config file
Default:
    --context Specify a custom authentication context name
    --http-retry-max Set maximum number of retries for requests that fail with a 429 or 500-level error
    Default: 5
    --http-retry-wait-max Set the minimum number of seconds to wait before retrying a failed request
    Default: 30
    --http-retry-wait-min Set the maximum number of seconds to wait before retrying a failed request
    Default: 1
    --interactive Enable interactive behavior. Defaults to true if the terminal supports it (default false)
    Default: false
    --output, -o Desired output format [text|json]
    Default: text
    --trace Show a log of network activity while performing a command
    Default: false
    --verbose, -v Enable verbose output
    Default: false

    We can't find any results for your search.

    Try using different keywords or simplifying your search terms.