mcpField
R
rwx

rwx

github.com/rwx-cloudCloud & DevOps3890 installsUpdated 1w ago
Repository

About rwx

rwx is a skill for using the RWX CLI to consult reference docs, run and inspect CI jobs, and work with sandboxes and configuration. It is intended for agents or developers maintaining RWX workflows.

Key features

  1. 01Pull and search RWX documentation
  2. 02Start runs and review results
  3. 03Check branch run status
  4. 04Execute commands in sandboxes
  5. 05Create, explain, and lint configuration

Use cases

  1. 01Look up RWX run-definition syntax
  2. 02Run a CI job and iterate on its outcome
  3. 03Investigate failed runs on a branch
  4. 04Validate an RWX configuration

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/rwx-cloud/skills --skill rwx

After installing, type/rwxin Claude Code to confirm it loaded.

Details

From the project README

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

Comments

Markdown supported