For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

Usage

doctl harness-runtime exec <session> -- <command> [args...] [flags]

Description

Run one command in a session’s sandbox and print its output.

Drives the sandbox directly rather than through its agent, so it works on a bare sandbox created with --template sandbox as well as on a managed-agent session.

Separate the guest command from doctl’s own flags with --, or flags meant for the guest (ls -la) are parsed as doctl flags.

Guest stdout and stderr pass through unchanged and the guest’s exit code becomes doctl’s, so this composes in pipelines and && chains. Each call is independent: there is no shell session between calls, so cd does not carry over — use --workdir, or run a shell explicitly (-- sh -c 'cd src && make').

Output is buffered until the command finishes, and capped at 1 MiB per stream. With -o json the full response is emitted instead of the raw streams.

Example

doctl harness-runtime exec sess_abc123 -- ls -la;

Flags

Related Commands

Global Flags