@runloop/rl-cli 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Runloop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,190 @@
+# Runloop CLI
+
+A beautiful, interactive CLI for managing Runloop devboxes built with Ink and TypeScript.
+
+## Features
+
+- 🎨 Beautiful terminal UI with colors and gradients
+- ⚡ Fast and responsive with pagination
+- 🔐 Secure API key management
+- 📦 Manage devboxes, snapshots, and blueprints
+- 🚀 Execute commands in devboxes
+- 📤 Upload files to devboxes
+- 🎯 Organized command structure with aliases
+
+## Installation
+
+Install globally via npm:
+
+```bash
+npm install -g @runloop/rl-cli
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/runloop/rl-cli-node.git
+cd rl-cli-node
+npm install
+npm run build
+npm link
+```
+
+## Setup
+
+Configure your API key using either method:
+
+### Option 1: Environment Variable (Recommended for CI/CD)
+
+```bash
+export RUNLOOP_API_KEY=your_api_key_here
+```
+
+### Option 2: Interactive Setup
+
+```bash
+rln auth
+```
+
+Get your API key from [https://runloop.ai/settings](https://runloop.ai/settings)
+
+## Usage
+
+### Authentication
+
+```bash
+# Interactive setup (stores API key locally)
+rln auth
+
+# Or use environment variable
+export RUNLOOP_API_KEY=your_api_key_here
+```
+
+The CLI will automatically use `RUNLOOP_API_KEY` if set, otherwise it will use the stored configuration.
+
+### Devbox Commands
+
+```bash
+# Create devboxes
+rln devbox create                           # Create with auto-generated name
+rln devbox create --name my-devbox          # Create with custom name
+rln devbox create --template nodejs         # Create from template
+rln d create -n my-devbox                   # Short alias
+
+# List devboxes (paginated)
+rln devbox list                             # List all devboxes
+rln devbox list --status running            # Filter by status
+rln d list                                  # Short alias
+
+# Execute commands
+rln devbox exec <devbox-id> echo "Hello"    # Run a command
+rln devbox exec <devbox-id> ls -la          # List files
+rln d exec <id> <command>                   # Short alias
+
+# Upload files
+rln devbox upload <devbox-id> ./file.txt    # Upload to home
+rln devbox upload <id> ./file.txt -p /path  # Upload to specific path
+rln d upload <id> <file>                    # Short alias
+
+# Delete devboxes
+rln devbox delete <devbox-id>               # Shutdown a devbox
+rln devbox rm <devbox-id>                   # Alias
+rln d delete <id>                           # Short alias
+```
+
+### Snapshot Commands
+
+```bash
+# Create snapshots
+rln snapshot create <devbox-id>             # Create snapshot
+rln snapshot create <id> --name backup-1    # Create with name
+rln snap create <id>                        # Short alias
+
+# List snapshots (paginated)
+rln snapshot list                           # List all snapshots
+rln snapshot list --devbox <id>             # Filter by devbox
+rln snap list                               # Short alias
+
+# Delete snapshots
+rln snapshot delete <snapshot-id>           # Delete snapshot
+rln snapshot rm <snapshot-id>               # Alias
+rln snap delete <id>                        # Short alias
+```
+
+### Blueprint Commands
+
+```bash
+# List blueprints
+rln blueprint list                          # List blueprints (coming soon)
+rln bp list                                 # Short alias
+```
+
+## Command Structure
+
+The CLI is organized into command buckets:
+
+- **`devbox` (alias: `d`)** - Manage devboxes
+  - `create` - Create new devboxes
+  - `list` - List devboxes with pagination
+  - `exec` - Execute commands
+  - `upload` - Upload files
+  - `delete` (alias: `rm`) - Shutdown devboxes
+
+- **`snapshot` (alias: `snap`)** - Manage snapshots
+  - `create` - Create snapshots
+  - `list` - List snapshots with pagination
+  - `delete` (alias: `rm`) - Delete snapshots
+
+- **`blueprint` (alias: `bp`)** - Manage blueprints
+  - `list` - List blueprints (coming soon)
+
+## Interactive Features
+
+- **Pagination** - Lists show 10 items per page with keyboard navigation
+  - `n` - Next page
+  - `p` - Previous page
+  - `q` - Quit
+- **Beautiful UI** - Gradient text, colored borders, Unicode icons
+- **Real-time Status** - Spinners and progress indicators
+- **Summary Stats** - Count running, stopped, and total resources
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Run CLI
+npm start -- <command>
+```
+
+## Tech Stack
+
+- [Ink](https://github.com/vadimdemedes/ink) - React for CLIs
+- [Ink Gradient](https://github.com/sindresorhus/ink-gradient) - Gradient text
+- [Ink Big Text](https://github.com/sindresorhus/ink-big-text) - ASCII art
+- [Commander.js](https://github.com/tj/commander.js) - CLI framework
+- [@runloop/api-client](https://github.com/runloopai/api-client-ts) - Runloop API client
+- TypeScript - Type safety
+- [Figures](https://github.com/sindresorhus/figures) - Unicode symbols
+
+## Publishing
+
+To publish a new version to npm:
+
+```bash
+npm run build
+npm publish
+```
+
+**Note:** Make sure you're logged in to npm with access to the `@runloop` organization.
+
+## License
+
+MIT

package/dist/cli.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { createDevbox } from './commands/devbox/create.js';
+import { listDevboxes } from './commands/devbox/list.js';
+import { deleteDevbox } from './commands/devbox/delete.js';
+import { execCommand } from './commands/devbox/exec.js';
+import { uploadFile } from './commands/devbox/upload.js';
+import { getConfig } from './utils/config.js';
+const program = new Command();
+program
+    .name('rln')
+    .description('Beautiful CLI for Runloop devbox management')
+    .version('1.0.0');
+program
+    .command('auth')
+    .description('Configure API authentication')
+    .action(async () => {
+    const { default: auth } = await import('./commands/auth.js');
+    auth();
+});
+// Devbox commands
+const devbox = program
+    .command('devbox')
+    .description('Manage devboxes')
+    .alias('d');
+devbox
+    .command('create')
+    .description('Create a new devbox')
+    .option('-n, --name <name>', 'Devbox name')
+    .option('-t, --template <template>', 'Template to use')
+    .option('-o, --output [format]', 'Output format: text|json|yaml (default: interactive)')
+    .action(createDevbox);
+devbox
+    .command('list')
+    .description('List all devboxes')
+    .option('-s, --status <status>', 'Filter by status')
+    .option('-o, --output [format]', 'Output format: text|json|yaml (default: interactive)')
+    .action(listDevboxes);
+devbox
+    .command('delete <id>')
+    .description('Shutdown a devbox')
+    .alias('rm')
+    .option('-o, --output [format]', 'Output format: text|json|yaml (default: interactive)')
+    .action(deleteDevbox);
+devbox
+    .command('exec <id> <command...>')
+    .description('Execute a command in a devbox')
+    .option('-o, --output [format]', 'Output format: text|json|yaml (default: interactive)')
+    .action(execCommand);
+devbox
+    .command('upload <id> <file>')
+    .description('Upload a file to a devbox')
+    .option('-p, --path <path>', 'Target path in devbox')
+    .option('-o, --output [format]', 'Output format: text|json|yaml (default: interactive)')
+    .action(uploadFile);
+// Snapshot commands
+const snapshot = program
+    .command('snapshot')
+    .description('Manage devbox snapshots')
+    .alias('snap');
+snapshot
+    .command('list')
+    .description('List all snapshots')
+    .option('-d, --devbox <id>', 'Filter by devbox ID')
+    .option('-o, --output [format]', 'Output format: text|json|yaml (default: interactive)')
+    .action(async (options) => {
+    const { listSnapshots } = await import('./commands/snapshot/list.js');
+    listSnapshots(options);
+});
+snapshot
+    .command('create <devbox-id>')
+    .description('Create a snapshot of a devbox')
+    .option('-n, --name <name>', 'Snapshot name')
+    .option('-o, --output [format]', 'Output format: text|json|yaml (default: interactive)')
+    .action(async (devboxId, options) => {
+    const { createSnapshot } = await import('./commands/snapshot/create.js');
+    createSnapshot(devboxId, options);
+});
+snapshot
+    .command('delete <id>')
+    .description('Delete a snapshot')
+    .alias('rm')
+    .option('-o, --output [format]', 'Output format: text|json|yaml (default: interactive)')
+    .action(async (id, options) => {
+    const { deleteSnapshot } = await import('./commands/snapshot/delete.js');
+    deleteSnapshot(id, options);
+});
+// Blueprint commands
+const blueprint = program
+    .command('blueprint')
+    .description('Manage blueprints')
+    .alias('bp');
+blueprint
+    .command('list')
+    .description('List all blueprints')
+    .option('-o, --output [format]', 'Output format: text|json|yaml (default: interactive)')
+    .action(async (options) => {
+    const { listBlueprints } = await import('./commands/blueprint/list.js');
+    listBlueprints(options);
+});
+// Check if API key is configured (except for auth command)
+const args = process.argv.slice(2);
+if (args[0] !== 'auth' && args[0] !== '--help' && args[0] !== '-h' && args.length > 0) {
+    const config = getConfig();
+    if (!config.apiKey) {
+        console.error('\n❌ API key not configured. Run: rln auth\n');
+        process.exit(1);
+    }
+}
+program.parse();

package/dist/commands/auth.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { render, Box, Text, useInput } from 'ink';
+import TextInput from 'ink-text-input';
+import { setApiKey } from '../utils/config.js';
+import { Header } from '../components/Header.js';
+import { Banner } from '../components/Banner.js';
+import { SuccessMessage } from '../components/SuccessMessage.js';
+const AuthUI = () => {
+    const [apiKey, setApiKeyInput] = React.useState('');
+    const [saved, setSaved] = React.useState(false);
+    useInput((input, key) => {
+        if (key.return && apiKey.trim()) {
+            setApiKey(apiKey.trim());
+            setSaved(true);
+            setTimeout(() => process.exit(0), 1000);
+        }
+    });
+    if (saved) {
+        return (_jsxs(_Fragment, { children: [_jsx(Banner, {}), _jsx(Header, { title: "Authentication" }), _jsx(SuccessMessage, { message: "API key saved!", details: "Try: rln devbox list" })] }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Banner, {}), _jsx(Header, { title: "Authentication" }), _jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { color: "gray", children: "Get your key: " }), _jsx(Text, { color: "cyan", children: "https://runloop.ai/settings" })] }), _jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: "API Key: " }), _jsx(TextInput, { value: apiKey, onChange: setApiKeyInput, placeholder: "rl_...", mask: "*" })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", dimColor: true, children: "Press Enter to save" }) })] }));
+};
+export default function auth() {
+    console.clear();
+    render(_jsx(AuthUI, {}));
+}