rwx runs list

List runs, most recent first.

Usage

rwx runs list [flags]

ls is an alias for list.

Description

The default output is a table. Pass --json (or --format json) for the structured payload, which includes a NextCursor for deliberate paging.

Results are paginated: the default page shows the most recent runs, and --limit sets the page size (capped at 100). When more runs remain, pass the reported cursor to --cursor to fetch the next page.

For a given run's full payload, use rwx results <id> --json.

Examples

List your most recent runs:

rwx runs list --mine

List failed runs on the main branch:

rwx runs list --branch main --result-status failed

Fetch the next page of results using a cursor from a prior --json response:

rwx runs list --limit 50 --cursor <next-cursor>

Options

--mine

Only list runs you triggered.

--branch <branch>

Filter by branch name, case-insensitive. Can be specified multiple times.

--commit <sha>

Filter by commit SHA. Can be specified multiple times.

--repository <repo>

Filter by repository name, case-insensitive. Can be specified multiple times.

--definition <path>

Filter by definition path. Can be specified multiple times.

--execution-status <status>

Filter by execution status. Can be specified multiple times. One of waiting, in_progress, finished, or aborted.

--result-status <status>

Filter by result status. Can be specified multiple times. One of succeeded, debugged, sandboxed, failed, or no_result.

--limit <count>

Page size. Capped at 100; the server default applies when unset.

--cursor <cursor>

Cursor for fetching the next page, taken from a prior result's NextCursor.

Global Options

--format <format>

Output format: text or json. Defaults to text.

In json mode, the payload includes a NextCursor for paging through additional results.

--json

Output JSON data to stdout. Equivalent to --format json.

--access-token <token>

The access token for RWX. Defaults to the value of the $RWX_ACCESS_TOKEN environment variable.