training-gym run

"# training-gym run\n\nInspect and manage runs.\n\n**Usage**:\n\n```bash\ntraining-gym run [OPTIONS] COMMAND [ARGS]...\n```\n\n**Options**:\n\n* `--help`: Show this message and exit.\n\n**Commands**:\n\n* [`training-gym run get`](#training-gym-run-get): Show a run's status and top-level metadata.\n* [`training-gym run params`](#training-gym-run-params): Show a run's framework training recipe.\n* [`training-gym run logs`](#training-gym-run-logs): Show logs for a training run.\n* [`training-gym run trace`](#training-gym-run-trace): Download agent traces for a run.\n* [`training-gym run list`](#training-gym-run-list): List training runs and top-level metadata.\n\n## `training-gym run get`\n\nShow a run's status and top-level metadata.\n\n**Usage**:\n\n```bash\ntraining-gym run get [OPTIONS] RUN_ID\n```\n\n**Options**:\n\n* `--verbose`: Include reward-over-time and rollout data.\n* `-j, --json`: Output machine-readable JSON.\n* `--help`: Show this message and exit.\n\n**Examples**:\n\n```bash\ntraining-gym run get brave-falcon-3fa8\ntraining-gym run get brave-falcon-3fa8 --verbose\n```\n\n## `training-gym run params`\n\nShow a run's framework training recipe.\n\n**Usage**:\n\n```bash\ntraining-gym run params [OPTIONS] RUN_ID\n```\n\n**Options**:\n\n* `-j, --json`: Output machine-readable JSON.\n* `--help`: Show this message and exit.\n\n**Examples**:\n\n```bash\ntraining-gym run params brave-falcon-3fa8\ntraining-gym run params brave-falcon-3fa8 --json\n```\n\n## `training-gym run logs`\n\nShow logs for a training run.\n\n**Usage**:\n\n```bash\ntraining-gym run logs [OPTIONS] RUN_ID\n```\n\n**Options**:\n\n* `-f, --follow`: Keep streaming new logs until interrupted or the run stops.\n* `--since START`: Show logs since a timestamp or relative time, such as 30m or 2h.\n* `--until END`: Show logs up to a timestamp or relative time, such as 30m or 2h.\n* `-n, --tail N`: Show at most N recent logs in the requested window. Default `100`; range `1` to `20000`.\n* `--search TEXT`: Filter by search text.\n* `-j, --json`: Output machine-readable JSON.\n* `--help`: Show this message and exit.\n\n**Examples**:\n\n```bash\ntraining-gym run logs brave-falcon-3fa8 --follow\ntraining-gym run logs brave-falcon-3fa8 --since 30m -j\n```\n\n## `training-gym run trace`\n\nDownload agent traces for a run.\n\n**Usage**:\n\n```bash\ntraining-gym run trace [OPTIONS] RUN_ID\n```\n\n**Options**:\n\n* `--out DIR`: Output directory. Required.\n* `--step STEP`: Select steps by list or end-exclusive range, or omit to select all steps.\n* `--dry-run`: Report step/sample count and approximate size without downloading.\n* `-y, --yes, --force`: Run without pausing for confirmation.\n* `-j, --json`: Output machine-readable JSON.\n* `--help`: Show this message and exit.\n\n**Examples**:\n\n```bash\ntraining-gym run trace brave-falcon-3fa8 --out ./traces --step 4-100:2\ntraining-gym run trace brave-falcon-3fa8 --out ./traces --step 1,4,9 --dry-run\ntraining-gym run trace brave-falcon-3fa8 --out ./traces --yes\n```\n\n## `training-gym run list`\n\nList training runs and top-level metadata.\n\nResults are sorted by most recently updated.\n\n**Usage**:\n\n```bash\ntraining-gym run list [OPTIONS]\n```\n\n**Options**:\n\n* `--status STATUS`: Filter by status.\n* `--model MODEL`: Filter by model.\n* `--dataset DATASET`: Filter by dataset.\n* `--recipe RECIPE`: Filter by recipe.\n* `--group GROUP`: Filter by group.\n* `--since TIME`: Include runs created or updated since this timestamp or relative time.\n* `--limit N`: Maximum number of runs to return. Default `50`; minimum `1`.\n* `-j, --json`: Output machine-readable JSON.\n* `--help`: Show this message and exit.\n\n**Examples**:\n\n```bash\ntraining-gym run list --status failed --since 24h\ntraining-gym run list --status completed --group nightly-tau-bench -j\n```\n"

Inspect and manage runs.

Usage:

training-gym run [OPTIONS] COMMAND [ARGS]...

Options:

--help: Show this message and exit.

Commands:

training-gym run get: Show a run’s status and top-level metadata.
training-gym run params: Show a run’s framework training recipe.
training-gym run logs: Show logs for a training run.
training-gym run trace: Download agent traces for a run.
training-gym run list: List training runs and top-level metadata.

`training-gym run get`

Show a run’s status and top-level metadata.

Usage:

training-gym run get [OPTIONS] RUN_ID

Options:

--verbose: Include reward-over-time and rollout data.
-j, --json: Output machine-readable JSON.
--help: Show this message and exit.

Examples:

training-gym run get brave-falcon-3fa8
training-gym run get brave-falcon-3fa8 --verbose

`training-gym run params`

Show a run’s framework training recipe.

Usage:

training-gym run params [OPTIONS] RUN_ID

Options:

-j, --json: Output machine-readable JSON.
--help: Show this message and exit.

Examples:

training-gym run params brave-falcon-3fa8
training-gym run params brave-falcon-3fa8 --json

`training-gym run logs`

Show logs for a training run.

Usage:

training-gym run logs [OPTIONS] RUN_ID

Options:

-f, --follow: Keep streaming new logs until interrupted or the run stops.
--since START: Show logs since a timestamp or relative time, such as 30m or 2h.
--until END: Show logs up to a timestamp or relative time, such as 30m or 2h.
-n, --tail N: Show at most N recent logs in the requested window. Default 100; range 1 to 20000.
--search TEXT: Filter by search text.
-j, --json: Output machine-readable JSON.
--help: Show this message and exit.

Examples:

training-gym run logs brave-falcon-3fa8 --follow
training-gym run logs brave-falcon-3fa8 --since 30m -j

`training-gym run trace`

Download agent traces for a run.

Usage:

training-gym run trace [OPTIONS] RUN_ID

Options:

--out DIR: Output directory. Required.
--step STEP: Select steps by list or end-exclusive range, or omit to select all steps.
--dry-run: Report step/sample count and approximate size without downloading.
-y, --yes, --force: Run without pausing for confirmation.
-j, --json: Output machine-readable JSON.
--help: Show this message and exit.

Examples:

training-gym run trace brave-falcon-3fa8 --out ./traces --step 4-100:2
training-gym run trace brave-falcon-3fa8 --out ./traces --step 1,4,9 --dry-run
training-gym run trace brave-falcon-3fa8 --out ./traces --yes

`training-gym run list`

List training runs and top-level metadata.

Results are sorted by most recently updated.

Usage:

training-gym run list [OPTIONS]

Options:

--status STATUS: Filter by status.
--model MODEL: Filter by model.
--dataset DATASET: Filter by dataset.
--recipe RECIPE: Filter by recipe.
--group GROUP: Filter by group.
--since TIME: Include runs created or updated since this timestamp or relative time.
--limit N: Maximum number of runs to return. Default 50; minimum 1.
-j, --json: Output machine-readable JSON.
--help: Show this message and exit.

Examples:

training-gym run list --status failed --since 24h
training-gym run list --status completed --group nightly-tau-bench -j