# Rwx

> Used to create, modify, or understand an RWX CI/CD config or any other file in a `.rwx` directory. TRIGGER when: the user asks about RWX; wants to create or modify an RWX config; says things like "CI failed", "CI is red", or "tests are failing in CI"; asks "what's failing on my PR / branch / commit?"; wants to run tests or build steps in a sandbox; wants to debug test failures, check a run status, fetch logs/artifacts, or start a run loop.

- Skill: `rwx-cloud/rwx` (Agent Skill)
- Install (CLI): `npx skillmds add rwx-cloud/rwx`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rwx-cloud/rwx/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: rwx-cloud (https://skillmd.com/u/rwx-cloud)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/rwx-cloud/rwx

---


# Using RWX

Ensure the user is signed in and on the latest version of the RWX CLI before
getting started: `rwx whoami`

## RWX Run Definition Syntax

When working with RWX, it is extremely important to use the reference
documentation. Run the following command to pull the reference documentation.
The output is already constrained in size, and it is very important to not
truncate the output of this command.

`rwx docs pull /migrating/rwx-reference`

If you encounter a question not covered by these references, use
`rwx docs search "<query>"` to find the relevant documentation page, then
`rwx docs pull` the result.

## Executing Runs

If the user chooses, you can kick off an actual run on RWX:

`rwx run .rwx/<file>.yml --wait`

When the run finishes, results will be shown, and you can iterate until the run
passes.

You do not need to commit or push to invoke a run with RWX, even if the run
definition references a commit sha. RWX will automatically patch the git clone
with the local contents.

## Check CI / run results or status of a branch

If you have been asked to check on run failures or CI failures, or if you have
been asked to check the current run status of the current branch or a given
branch:

`rwx results -h`

## Sandboxes

If the user mentions using a sandbox:

`rwx sandbox exec -- <command>`

## Generate or Modify RWX Config

You may have been tasked with creating, modifying, or understanding/explaining
an RWX CI/CD config for this project. Use the same aforementioned documentation.

When making changes, you can run validation on the config:

    rwx lint .rwx/<name>.yml