Commands

rbtk organises commands into groups. This page is the index; each group has its own deep-dive page with full flag tables and examples. Run rbtk --help for a live tree, or rbtk <group> --help to drill in.

Global flags

These flags work on every command.

Flag	Default	Description
`--output table\|json\|yaml`	`table` (TTY), `json` (non-TTY)	Output format. See Output formats.
`--project <slug>`	from context	Override the project for this invocation.
`--org <slug>`	from context	Override the org for this invocation.
`--api-key <key>`	from env / keyring	Override the API key for this invocation.
`--debug`	off	Print HTTP requests, response status, and timing.
`--quiet`	off	Suppress progress and informational lines.
`--no-color`	off	Disable ANSI colour output.

Command groups

Group	What it does	Deep dive
`rbtk auth`	Log in/out, status, GitHub OIDC exchange, API key management	Context & auth commands
`rbtk context`	Switch the active org and project; show current selection	Context & auth commands
`rbtk test`	Run tests, watch live progress, inspect cases, fetch logs / files / evidence packs	Test commands
`rbtk requirements`	Upload, list, show requirements; export and coverage reports	Requirements commands
`rbtk github`	Link/unlink repos, show GitHub App status	GitHub commands
`rbtk pool`	List, create, delete pools; register runners; per-pool stats	Pool commands
`rbtk log`	Stream test-run logs in real time	Test commands → logs
`rbtk org`	List, get orgs you can access	covered in Context & auth
`rbtk project`	List, get projects in the current org	covered in Context & auth

Recipes by intent

Goal	Command
Run my repo’s tests once	`rbtk test run --push ./`
Run on hosted Gazebo GPU	`rbtk test cloud --pool hosted-gazebo-gpu --push ./`
Watch a queued run go live	`rbtk test watch <run-id>`
List test cases that ran	`rbtk test cases <run-id>`
Download a single test’s artifacts	`rbtk test files <run-id> --nodeid "tests/test_x.py::test_y" --download --out ./test_y/`
Pull the latest evidence pack	`rbtk test evidence-pack latest --out ./evidence/`
Upload a ReqIF file	`rbtk requirements upload reqs.reqif`
See which requirements are uncovered	`rbtk requirements coverage --filter uncovered`
Tail logs of a running test	`rbtk log <run-id>`
Create a self-hosted pool	`rbtk pool create --name gpu-prod --type self-hosted`
Mint a runner registration token	`rbtk pool register-runner --pool gpu-prod`
Switch project	`rbtk context set --project warehouse`

Exit codes

Code	Meaning
`0`	Success
`1`	Generic failure (logic error, API error)
`2`	Bad CLI invocation (unknown flag, missing arg)
`3`	Authentication failure
`4`	Authorization failure (wrong scope, no access)
`5`	Resource not found
`6`	Validation failure (e.g., ReqIF malformed)
`7`	Test run finished but failed (`rbtk test run` etc.)
`8`	Pool / runner offline or unavailable

Use these in shell scripts:

rbtk test run --push ./ --wait || exit_code=$?
case $exit_code in
  0) echo "PASS" ;;
  7) echo "Tests failed"; exit 1 ;;
  *) echo "Infrastructure error ($exit_code)"; exit 2 ;;
esac

Where to go next

Test commands

The largest group — run, list, results, logs, artifacts.

Requirements

Upload, coverage, export.

Pool commands

Operate runner pools from the CLI.

Output formats

JSON, YAML, sparkline tables, ID-only piping.

Quick Start

GitHub App

Requirements

Traceability

Testing

SDK

Self-Hosted Runners

AI Features

CLI

Evidence Packs

Standards Coverage

Compliance Patterns

Integrations

Pricing

Resources

Commands Reference

Commands

Global flags

Command groups

Recipes by intent

Exit codes

Where to go next

Test commands

Requirements

Pool commands

Output formats

​Commands

​Global flags

​Command groups

​Recipes by intent

​Exit codes

​Where to go next

Test commands

Requirements

Pool commands

Output formats

Commands

Global flags

Command groups

Recipes by intent

Exit codes

Where to go next