Getting started

RWX is a hosted CI service. To use it, you'll need to create an RWX Cloud account.

With RWX, you can run tasks without having to push to a git repository. The easiest way to get started is by using the CLI to initiate runs locally.

Installing the CLI

On macOS or WSL, install via Homebrew:

brew install rwx-cloud/tap/rwx

For Linux, version pinning, and notes on backwards compatibility, see Installing the CLI.

Login to use the CLI

You'll need to log in to use the CLI. Run rwx login and it will facilitate the authentication process.

Personal access tokens are associated to specific organizations, so you'll also need to create an organization or be a member of one.

To confirm that your CLI is authenticated, run rwx whoami

Set up version control

RWX usually requires you to connect a version control provider to verify your account before you can start runs.

Connect GitHub, Cursor Origin, Entire, GitLab, or Forgejo to enable runs. If you don't use a supported provider, contact support.

RWX skill

If you're using a coding agent like Claude Code, install the RWX skill to help your agent work with RWX:

rwx skill install

We recommend checking the skill in to your version control system to share with your team.

VS Code extension

If you're using VS Code, install the RWX VS Code Extension. Open the command palette and enter:

ext install RWX.rwx-vscode-extension

Hello world

Define the following hello world task in a tasks.yml file.

base:
  image: ubuntu:26.04
  config: rwx/base 1.2.2

tasks:
  - key: hello-world
    run: echo hello world

Running

Use the rwx CLI to run your hello world task.

rwx run tasks.yml

The CLI will print a URL where you can view the run results.

Run is watchable at https://cloud.rwx.com/mint/rwx/runs/421186a89f5b4f379d9fe7d712ad17b2

If you want to automatically open your browser when starting a run, use the --open option.

rwx run tasks.yml --open