doctl harness-runtime config list-sessions
Generated on 6 Oct 2026
from doctl version
v1.178.0
Usage
doctl harness-runtime config list-sessions <config-id> [flags]Aliases
sessionsDescription
List sessions started from a config. Filter with --status or --name.
Example
doctl harness-runtime config list-sessions cfg_abc123 --status SESSION_STATUS_READYFlags
| Option | Description |
|---|---|
--format |
Columns for output in a comma-separated list. Possible values: SessionID, Name, AgentKind, Status, ConfigID, ParentSessionID, ForkID, RepoHint, CreatedAt, PauseReason. |
--help, -h |
Help for this command |
--name |
Filter by session name |
--no-header |
Return raw data with no headers Default: false |
--page-size |
Maximum number of sessions to return per page Default: 0 |
--page-token |
Pagination cursor from a previous list response |
--status |
Filter by session status (e.g. SESSION_STATUS_READY) |
Related Commands
| Command | Description |
|---|---|
| doctl harness-runtime config | Manage reusable agent configs |
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 |