rwx logs

Download logs for a task (using the ID in the page's URL).

Usage

rwx logs [task-id | run-id --task <key>] [flags]

Arguments

[task-id]

The ID of the task to download logs for. You can find the task ID in the URL when viewing a task in the RWX UI.

Alternatively, pass a run ID with --task <key> to resolve the task by key.

Passing a top-level or "group" task ID (i.e. one with child tasks) will download the logs for all child tasks, automatically extracted to the output directory. This includes logs from any background processes that ran within those tasks.

Passing a "command" task ID (one without child tasks) will download a single .log file for that task. If the task had background processes, their logs will be included as additional files.

Options

--task <key>

Resolve the task by key (e.g. ci.checks.lint) instead of ID. Use with a run ID as the first argument.

--output-file <path> or --output-dir <directory>

The path or directory to save the logs to. These two flags are mutually exclusive.

If not specified, the logs will be saved to .rwx/downloads in your current working directory, or your downloads directory if not in an RWX project.

--zip

Skip automatic extraction and save the raw .zip archive instead. Useful if you want to handle the archive yourself.

--open

Automatically open the downloaded log file(s) in your default application.

Global Options

--output <format>

Output format: text or json. Defaults to text.

Example JSON output:

{
  "OutputFiles": [
    "/Users/me/Downloads/task123.log",
    "/Users/me/Downloads/task456.log"
  ]
}

--access-token <token>

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