Runloop CLI


A TUI + CLI for the Runloop.ai platform. Use it as an interactive TUI (Terminal User Interface) with rich UI components, or as a traditional CLI for scripting and automation.

📖 Full Documentation

Quick Example

``bash


TUI mode - launches an interactive terminal UI

rli

CLI mode - perfect for scripts and automation

rli devbox list # Outputs JSON/text
rli devbox create --name my-devbox
rli devbox exec echo "Hello World"
rli devbox delete
`

Features

- 🖥️ TUI mode — Interactive terminal UI with menus, tables, and real-time updates
- 🎯 CLI mode — Traditional commands with text, JSON, and YAML output for scripting
- ⚡ Fast and responsive with pagination
- 📦 Manage devboxes, snapshots, and blueprints
- 🚀 Execute commands, SSH, view logs in devboxes
- 🤖 Model Context Protocol (MCP) server for AI integration

Installation

Install globally via npm:

`bash
npm install -g @runloop/rl-cli
`

Setup

Configure your API key:

`bash
export RUNLOOP_API_KEY=your_api_key_here
`

Get your API key from https://runloop.ai/settings

Usage

$3

`bash
rli # Launch the interactive TUI
rli --help # See help information
`

$3

All commands support --output (-o) for format control:

`bash
rli devbox list # Default text output
rli devbox list -o json # JSON output
rli devbox list -o yaml # YAML output
`

Command Structure

The CLI is organized into command buckets:

$3

`bash
rli devbox create # Create a new devbox
rli devbox list # List all devboxes
rli devbox delete # Shutdown a devbox
rli devbox exec # Execute a command in a devbox
rli devbox exec-async # Execute a command asynchronously on a...
rli devbox upload # Upload a file to a devbox
rli devbox get # Get devbox details
rli devbox get-async # Get status of an async execution
rli devbox suspend # Suspend a devbox
rli devbox resume # Resume a suspended devbox
rli devbox shutdown # Shutdown a devbox
rli devbox ssh # SSH into a devbox
rli devbox scp # Copy files to/from a devbox using scp
rli devbox rsync # Sync files to/from a devbox using rsync
rli devbox tunnel # Create a port-forwarding tunnel to a ...
rli devbox read # Read a file from a devbox using the API
rli devbox write # Write a file to a devbox using the API
rli devbox download # Download a file from a devbox
rli devbox send-stdin # Send stdin to a running async execution
rli devbox logs # View devbox logs
`

$3

`bash
rli snapshot list # List all snapshots
rli snapshot create # Create a snapshot of a devbox
rli snapshot delete # Delete a snapshot
rli snapshot get # Get snapshot details
rli snapshot status # Get snapshot operation status
`

$3

`bash
rli blueprint list # List all blueprints
rli blueprint create # Create a new blueprint
rli blueprint get # Get blueprint details by name or ID (...
rli blueprint logs # Get blueprint build logs by name or I...
rli blueprint prune # Delete old blueprint builds, keeping ...
rli blueprint from-dockerfile # Create a blueprint from a Dockerfile ...
`

$3

`bash
rli object list # List objects
rli object get # Get object details
rli object download # Download object to local file
rli object upload # Upload a file as an object
rli object delete # Delete an object (irreversible)
`

$3

`bash
rli network-policy list # List network policies
rli network-policy get # Get network policy details
rli network-policy create # Create a new network policy
rli network-policy delete # Delete a network policy
`

$3

`bash
rli secret create # Create a new secret. Value can be pip...
rli secret list # List all secrets
rli secret get # Get secret metadata by name
rli secret update # Update a secret value (value from std...
rli secret delete # Delete a secret
`

$3

`bash
rli mcp start # Start the MCP server
rli mcp install # Install Runloop MCP server configurat...
`




MCP Server (AI Integration)

Runloop includes a Model Context Protocol (MCP) server that allows AI assistants like Claude to interact with your devboxes.

$3

`bash


Install MCP configuration

rli mcp install

Restart Claude Desktop, then ask Claude:

"List my devboxes" or "Create a new devbox"

`

$3

`bash


Stdio mode (for Claude Desktop)

rli mcp start

HTTP mode (for web/remote access)

rli mcp start --http
rli mcp start --http --port 8080
`

Documentation:

- CLAUDE_SETUP.md - Complete setup guide for Claude Desktop
- MCP_README.md - Full MCP documentation
- MCP_COMMANDS.md - Quick command reference

Theme Configuration

The TUI supports both light and dark terminal themes and will automatically select the appropriate theme.

Development

``bash

Install dependencies

npm install

Build

npm run build

Watch mode

npm run dev

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines on how to contribute to this project.

License

MIT