From 43b526f4e45645555557b207f3399d96a5b6779d Mon Sep 17 00:00:00 2001 From: James Chainey Date: Mon, 2 Mar 2026 09:57:39 -0800 Subject: [PATCH 1/2] add llms.txt --- llms.txt | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 llms.txt diff --git a/llms.txt b/llms.txt new file mode 100644 index 00000000..b2c26eb5 --- /dev/null +++ b/llms.txt @@ -0,0 +1,53 @@ +# Runloop CLI + +> Runloop CLI (`rli`) is a TUI + CLI for the [Runloop.ai](https://runloop.ai) platform. It manages devboxes (cloud development environments), snapshots, blueprints, objects, network policies, secrets, and gateway configurations. It also includes an MCP server for AI assistant integration. + +Important notes for AI agents: + +- The `RUNLOOP_API_KEY` environment variable must be set before running any command +- Use `-o json` or `-o yaml` flags for machine-readable output (most commands default to JSON for `list` and `get` operations) +- Run `rli --help` for top-level help, `rli --help` for command group help, and `rli --help` for detailed flag documentation +- Command aliases exist for convenience: `devbox`/`d`, `snapshot`/`snap`, `blueprint`/`bp`, `object`/`obj`, `network-policy`/`np`, `secret`/`s`, `gateway-config`/`gwc`, `mcp-config`/`mcpc` + +## Installation + +```bash +npm install -g @runloop/rl-cli +# or +pnpm add -g @runloop/rl-cli +``` + +Then configure authentication: + +```bash +export RUNLOOP_API_KEY=your_api_key_here +``` + +Get your API key from [https://runloop.ai/settings](https://runloop.ai/settings). + +## Core Commands + +- `rli devbox list` - List all devboxes (filter with `-s running`, `-s suspended`, etc.) +- `rli devbox create --name ` - Create a new devbox +- `rli devbox exec ` - Execute a command in a devbox +- `rli devbox ssh ` - SSH into a devbox +- `rli devbox delete ` - Shutdown and delete a devbox +- `rli snapshot list` - List snapshots +- `rli snapshot create ` - Create a snapshot +- `rli blueprint list` - List available blueprints + +## Docs + +- [README](https://github.com/runloopai/rl-cli/blob/main/README.md): Installation, setup, and complete command reference with examples +- [Full Documentation](https://docs.runloop.ai/docs/tools/rl-cli): Official Runloop CLI documentation + +## MCP Integration + +- [MCP README](https://github.com/runloopai/rl-cli/blob/main/MCP_README.md): Model Context Protocol server setup for AI assistants +- [Claude Setup](https://github.com/runloopai/rl-cli/blob/main/CLAUDE_SETUP.md): Step-by-step guide for Claude Desktop integration +- [MCP Commands](https://github.com/runloopai/rl-cli/blob/main/MCP_COMMANDS.md): Quick reference for MCP tools + +## Optional + +- [Contributing](https://github.com/runloopai/rl-cli/blob/main/CONTRIBUTING.md): Guidelines for contributing to the CLI +- [Changelog](https://github.com/runloopai/rl-cli/blob/main/CHANGELOG.md): Version history and release notes From 300f8a39759402459c80c3b8222c8af78ff81059 Mon Sep 17 00:00:00 2001 From: James Chainey Date: Mon, 2 Mar 2026 11:34:49 -0800 Subject: [PATCH 2/2] added scp and rsync; instructions for discovering extra commands --- llms.txt | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/llms.txt b/llms.txt index b2c26eb5..9a5235b3 100644 --- a/llms.txt +++ b/llms.txt @@ -31,11 +31,15 @@ Get your API key from [https://runloop.ai/settings](https://runloop.ai/settings) - `rli devbox create --name ` - Create a new devbox - `rli devbox exec ` - Execute a command in a devbox - `rli devbox ssh ` - SSH into a devbox +- `rli devbox scp ` - Copy files to/from a devbox (e.g., `rli devbox scp dbx_id:/remote ./local`) +- `rli devbox rsync ` - Sync files to/from a devbox using rsync - `rli devbox delete ` - Shutdown and delete a devbox - `rli snapshot list` - List snapshots - `rli snapshot create ` - Create a snapshot - `rli blueprint list` - List available blueprints +Use the help or explore this repo to discover the full set of commands. + ## Docs - [README](https://github.com/runloopai/rl-cli/blob/main/README.md): Installation, setup, and complete command reference with examples