Skip to content

Commit 60e9c81

Browse files
committed
cp dines
1 parent c0f2ed8 commit 60e9c81

36 files changed

Lines changed: 3388 additions & 469 deletions

CLAUDE_SETUP.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@ This guide will walk you through connecting the Runloop MCP server to Claude Des
55
## Prerequisites
66

77
1. Make sure you have Claude Desktop installed
8-
2. Authenticate with Runloop: `rln auth`
9-
3. Make sure `rln` is installed globally and in your PATH
8+
2. Authenticate with Runloop: `rli auth`
9+
3. Make sure `rli` is installed globally and in your PATH
1010

1111
## Quick Setup (Automatic)
1212

1313
The easiest way to set up Runloop with Claude Desktop:
1414

1515
```bash
16-
rln mcp install
16+
rli mcp install
1717
```
1818

1919
This command will:
@@ -54,7 +54,7 @@ If the file doesn't exist, create it. Add or update it with this configuration:
5454
{
5555
"mcpServers": {
5656
"runloop": {
57-
"command": "rln",
57+
"command": "rli",
5858
"args": ["mcp", "start"]
5959
}
6060
}
@@ -71,7 +71,7 @@ If the file doesn't exist, create it. Add or update it with this configuration:
7171
"args": ["some-args"]
7272
},
7373
"runloop": {
74-
"command": "rln",
74+
"command": "rli",
7575
"args": ["mcp", "start"]
7676
}
7777
}
@@ -98,17 +98,17 @@ Claude will now have access to these Runloop tools and can manage your devboxes!
9898

9999
## Troubleshooting
100100

101-
### "Command not found: rln"
101+
### "Command not found: rli"
102102

103-
Make sure `rln` is in your PATH. Test by running `which rln` (macOS/Linux) or `where rln` (Windows) in your terminal.
103+
Make sure `rli` is in your PATH. Test by running `which rli` (macOS/Linux) or `where rli` (Windows) in your terminal.
104104

105105
If not found:
106106
- If installed via npm globally: `npm install -g @runloop/rl-cli`
107107
- Check your npm global bin directory is in PATH: `npm config get prefix`
108108

109109
### "API key not configured"
110110

111-
Run `rln auth` to configure your API key before using the MCP server.
111+
Run `rli auth` to configure your API key before using the MCP server.
112112

113113
### Claude doesn't show Runloop tools
114114

@@ -123,7 +123,7 @@ Run `rln auth` to configure your API key before using the MCP server.
123123
You can test if the MCP server is working by running:
124124

125125
```bash
126-
rln mcp start
126+
rli mcp start
127127
```
128128

129129
It should output: `Runloop MCP server running on stdio`
@@ -140,7 +140,7 @@ If you want to connect to Runloop's development environment:
140140
{
141141
"mcpServers": {
142142
"runloop": {
143-
"command": "rln",
143+
"command": "rli",
144144
"args": ["mcp", "start"],
145145
"env": {
146146
"RUNLOOP_ENV": "dev"
@@ -152,20 +152,20 @@ If you want to connect to Runloop's development environment:
152152

153153
### Using a Specific Path
154154

155-
If `rln` isn't in your PATH, you can specify the full path:
155+
If `rli` isn't in your PATH, you can specify the full path:
156156

157157
```json
158158
{
159159
"mcpServers": {
160160
"runloop": {
161-
"command": "/full/path/to/rln",
161+
"command": "/full/path/to/rli",
162162
"args": ["mcp", "start"]
163163
}
164164
}
165165
}
166166
```
167167

168-
Find the full path with: `which rln` (macOS/Linux) or `where rln` (Windows)
168+
Find the full path with: `which rli` (macOS/Linux) or `where rli` (Windows)
169169

170170
## What Can Claude Do Now?
171171

MCP_COMMANDS.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Quick reference for all Runloop MCP commands.
99
Automatically configure Claude Desktop to use Runloop MCP:
1010

1111
```bash
12-
rln mcp install
12+
rli mcp install
1313
```
1414

1515
This command:
@@ -27,7 +27,7 @@ After running this, restart Claude Desktop.
2727
Start the MCP server in stdio mode:
2828

2929
```bash
30-
rln mcp start
30+
rli mcp start
3131
```
3232

3333
This mode is used by Claude Desktop and other local AI assistants. The server communicates via stdin/stdout.
@@ -37,7 +37,7 @@ This mode is used by Claude Desktop and other local AI assistants. The server co
3737
Start the MCP server in HTTP mode:
3838

3939
```bash
40-
rln mcp start --http
40+
rli mcp start --http
4141
```
4242

4343
This starts an HTTP server on port 3000 by default, using Server-Sent Events (SSE) for communication.
@@ -47,18 +47,18 @@ This starts an HTTP server on port 3000 by default, using Server-Sent Events (SS
4747
Start the HTTP server on a specific port:
4848

4949
```bash
50-
rln mcp start --http --port 8080
50+
rli mcp start --http --port 8080
5151
```
5252

5353
## Configuration File Format
5454

55-
When you run `rln mcp install`, it creates this configuration in your Claude Desktop config:
55+
When you run `rli mcp install`, it creates this configuration in your Claude Desktop config:
5656

5757
```json
5858
{
5959
"mcpServers": {
6060
"runloop": {
61-
"command": "rln",
61+
"command": "rli",
6262
"args": ["mcp", "start"]
6363
}
6464
}
@@ -73,7 +73,7 @@ To use the development environment:
7373
{
7474
"mcpServers": {
7575
"runloop": {
76-
"command": "rln",
76+
"command": "rli",
7777
"args": ["mcp", "start"],
7878
"env": {
7979
"RUNLOOP_ENV": "dev"
@@ -120,15 +120,15 @@ Once set up, you can ask Claude:
120120
Test the stdio server manually:
121121

122122
```bash
123-
rln mcp start
123+
rli mcp start
124124
```
125125

126126
You should see: `Runloop MCP server running on stdio`
127127

128128
Test the HTTP server:
129129

130130
```bash
131-
rln mcp start --http
131+
rli mcp start --http
132132
```
133133

134134
You should see:
@@ -142,19 +142,19 @@ Message endpoint: http://localhost:3000/message
142142

143143
### Command not found
144144

145-
If you get "command not found: rln":
145+
If you get "command not found: rli":
146146
- Install globally: `npm install -g @runloop/rl-cli`
147147
- Check your PATH includes npm global bin directory
148148

149149
### API key not configured
150150

151-
Run `rln auth` before using the MCP server.
151+
Run `rli auth` before using the MCP server.
152152

153153
### Port already in use
154154

155155
For HTTP mode, use a different port:
156156
```bash
157-
rln mcp start --http --port 8080
157+
rli mcp start --http --port 8080
158158
```
159159

160160
## See Also

MCP_README.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Runloop provides two transport modes for the MCP server:
1515
For local AI assistants like Claude Desktop:
1616

1717
```bash
18-
rln mcp start
18+
rli mcp start
1919
```
2020

2121
The server runs on stdio and communicates using the MCP protocol.
@@ -25,13 +25,13 @@ The server runs on stdio and communicates using the MCP protocol.
2525
For web-based AI assistants or remote access:
2626

2727
```bash
28-
rln mcp start --http
28+
rli mcp start --http
2929
```
3030

3131
Or specify a custom port:
3232

3333
```bash
34-
rln mcp start --http --port 8080
34+
rli mcp start --http --port 8080
3535
```
3636

3737
The HTTP server runs on `http://localhost:3000` by default and uses Server-Sent Events (SSE) for communication.
@@ -83,7 +83,7 @@ The MCP server exposes the following tools:
8383
The easiest way to set up with Claude Desktop:
8484

8585
```bash
86-
rln mcp install
86+
rli mcp install
8787
```
8888

8989
This automatically adds the configuration to your Claude Desktop config file and preserves any existing MCP servers.
@@ -100,7 +100,7 @@ If you prefer to configure manually, add this to your Claude configuration file:
100100
{
101101
"mcpServers": {
102102
"runloop": {
103-
"command": "rln",
103+
"command": "rli",
104104
"args": ["mcp", "start"],
105105
"env": {
106106
"RUNLOOP_ENV": "prod"
@@ -134,7 +134,7 @@ Example for Claude Code or other MCP clients supporting HTTP:
134134
The MCP server uses the same API key configuration as the CLI. Make sure you've authenticated first:
135135

136136
```bash
137-
rln auth
137+
rli auth
138138
```
139139

140140
The server will automatically use your stored API credentials.
@@ -154,32 +154,32 @@ Claude will use the MCP tools to interact with your Runloop account and provide
154154
## Environment Variables
155155

156156
- `RUNLOOP_ENV` - Set to `dev` for development environment, `prod` (or leave unset) for production
157-
- API key is read from the CLI configuration (~/.config/rln/config.json)
157+
- API key is read from the CLI configuration (~/.config/rli/config.json)
158158

159159
## Troubleshooting
160160

161161
### Stdio Server
162162

163163
If the stdio MCP server isn't working:
164164

165-
1. Make sure you've run `rln auth` to configure your API key
166-
2. Check that the `rln` command is in your PATH
165+
1. Make sure you've run `rli auth` to configure your API key
166+
2. Check that the `rli` command is in your PATH
167167
3. Restart Claude Desktop after updating the configuration
168168
4. Check Claude's logs for any error messages
169169

170170
### HTTP Server
171171

172172
If the HTTP MCP server isn't working:
173173

174-
1. Make sure you've run `rln auth` to configure your API key
174+
1. Make sure you've run `rli auth` to configure your API key
175175
2. Check that the port isn't already in use
176176
3. Verify the server is running: `curl http://localhost:3000/sse`
177177
4. Check your firewall settings if connecting remotely
178178
5. Look at the server logs for error messages
179179

180180
### Common Issues
181181

182-
- **"API key not configured"**: Run `rln auth` to set up your credentials
182+
- **"API key not configured"**: Run `rli auth` to set up your credentials
183183
- **Port already in use**: Stop other services or use a different port with `--port`
184184
- **Connection refused**: Make sure the server is running and accessible
185185

OUTPUT_FORMAT_SUMMARY.md

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -21,62 +21,62 @@ Created `/src/utils/output.ts` with the following functions:
2121
## Commands Updated
2222

2323
### List Commands (with `-o json`)
24-
-`rln devbox list [-s <status>] -o json`
25-
-`rln blueprint list -o json`
26-
-`rln snapshot list [-d <devbox-id>] -o json`
24+
-`rli devbox list [-s <status>] -o json`
25+
-`rli blueprint list -o json`
26+
-`rli snapshot list [-d <devbox-id>] -o json`
2727

2828
### Create Commands (with `-o json`)
29-
-`rln devbox create [-n <name>] [-t <template>] -o json`
30-
-`rln snapshot create <devbox-id> [-n <name>] -o json`
29+
-`rli devbox create [-n <name>] [-t <template>] -o json`
30+
-`rli snapshot create <devbox-id> [-n <name>] -o json`
3131

3232
### Delete Commands (with `-o json`)
33-
-`rln devbox delete <id> -o json`
34-
-`rln snapshot delete <id> -o json`
33+
-`rli devbox delete <id> -o json`
34+
-`rli snapshot delete <id> -o json`
3535

3636
### Other Commands (NOT YET IMPLEMENTED)
37-
- ⏸️ `rln devbox exec <id> <command...> -o json`
38-
- ⏸️ `rln devbox upload <id> <file> -o json`
37+
- ⏸️ `rli devbox exec <id> <command...> -o json`
38+
- ⏸️ `rli devbox upload <id> <file> -o json`
3939

4040
## Usage Examples
4141

4242
### Interactive Mode (Default)
4343
```bash
4444
# Shows full UI with table, navigation, operations
45-
rln devbox list
46-
rln blueprint list
45+
rli devbox list
46+
rli blueprint list
4747
```
4848

4949
### JSON Output for Scripting
5050
```bash
5151
# Get all devboxes as JSON
52-
rln devbox list -o json
52+
rli devbox list -o json
5353

5454
# Filter and format with jq
55-
rln devbox list -s running -o json | jq '.[] | {id, name, status}'
55+
rli devbox list -s running -o json | jq '.[] | {id, name, status}'
5656

5757
# Create devbox and capture ID
58-
DEVBOX_ID=$(rln devbox create -n my-box -o json | jq -r '.id')
58+
DEVBOX_ID=$(rli devbox create -n my-box -o json | jq -r '.id')
5959

6060
# List snapshots for specific devbox
61-
rln snapshot list -d <devbox-id> -o json
61+
rli snapshot list -d <devbox-id> -o json
6262

6363
# Delete and get confirmation
64-
rln devbox delete <id> -o json
64+
rli devbox delete <id> -o json
6565
```
6666

6767
### YAML Output for Readability
6868
```bash
6969
# Get all devboxes as YAML
70-
rln devbox list -o yaml
70+
rli devbox list -o yaml
7171

7272
# Create devbox with YAML output
73-
rln devbox create -n my-box -o yaml
73+
rli devbox create -n my-box -o yaml
7474

7575
# List blueprints as YAML
76-
rln blueprint list -o yaml
76+
rli blueprint list -o yaml
7777

7878
# Output to file for configuration
79-
rln devbox list -o yaml > devboxes.yaml
79+
rli devbox list -o yaml > devboxes.yaml
8080
```
8181

8282
### Integration with CI/CD
@@ -85,19 +85,19 @@ rln devbox list -o yaml > devboxes.yaml
8585
# Create devbox, wait for running status, execute command
8686

8787
# Create
88-
DEVBOX=$(rln devbox create -n ci-box -o json)
88+
DEVBOX=$(rli devbox create -n ci-box -o json)
8989
DEVBOX_ID=$(echo "$DEVBOX" | jq -r '.id')
9090

9191
# Poll until running
92-
while [ "$(rln devbox list -o json | jq -r ".[] | select(.id==\"$DEVBOX_ID\") | .status")" != "running" ]; do
92+
while [ "$(rli devbox list -o json | jq -r ".[] | select(.id==\"$DEVBOX_ID\") | .status")" != "running" ]; do
9393
sleep 5
9494
done
9595

9696
# Execute commands (needs -o json implementation)
97-
rln devbox exec "$DEVBOX_ID" npm test
97+
rli devbox exec "$DEVBOX_ID" npm test
9898

9999
# Cleanup
100-
rln devbox delete "$DEVBOX_ID" -o json
100+
rli devbox delete "$DEVBOX_ID" -o json
101101
```
102102

103103
## Implementation Pattern

0 commit comments

Comments
 (0)