doctl harness-runtime
Generated on 23 Sep 2026
from doctl version
v1.173.0
Usage
doctl harness-runtime [flags]Aliases
agent, agents, ohrDescription
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:
launchputs you in a session — creating it first if you gave it something to create from, or attaching to one you already have.createmakes 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-sessionSession 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 |
Related Commands
| 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 |