Blade CLI Reference

Commands for managing GPU blade sessions — connecting, monitoring, configuring SSH, and transferring files.

rb blade list

List your active and recent blades.

Synopsis

rb blade list

Description

Shows the GPU blades assigned to your account, with their event, GPU type, status, and IP address.

Example

$ rb blade list
ID        Event       GPU              Status    IP
abc12345  CUDA-2026   gpu-l40sx1-48gb  running   51.159.42.10
def45678  NLP-LAB-03  gpu-h100x1-80gb  stopped   —

rb blade ssh

SSH into a blade.

Synopsis

rb blade ssh [BLADE_ID]

Description

Opens an interactive SSH session to a blade. If no blade ID is given, connects to your most recent running blade. With sshpass installed the connection is fully passwordless; otherwise the one-time password is printed for you to paste. Host-key checking is disabled (blades are ephemeral).

Options

BLADE_ID — optional 8-character blade id prefix (from rb blade list). Defaults to the most recent running blade.

Example

$ rb blade ssh
Connecting to [email protected]:22012...

student@gpu-blade:~$

rb run

Run a command on a blade over SSH and stream its output — no manual ssh, no launcher script.

Synopsis

rb run COMMAND [--blade BLADE_ID]

Description

Runs COMMAND on your most recent running blade (or --blade) and exits with the command's exit code. Uses the same SSH path as rb blade ssh (passwordless with sshpass).

Example

$ rb run nvidia-smi
$ rb run "python train.py --epochs 10"

rb blade status

Show detailed blade information.

Synopsis

rb blade status [BLADE_ID]

Description

Displays GPU type, IP address, uptime, and time remaining for the blade. If the blade is within 15 minutes of teardown, a warning is shown.

Example

$ rb blade status
Blade: gpu-blade-abc123
  Status:    running
  GPU:       NVIDIA L40S (48 GB VRAM)
  IP:        145.239.12.87
  Uptime:    1h 23m
  Remaining: 1h 37m
  Event:     ML Workshop — Spring 2026 (CUDA-2026)

$ rb blade status
Blade: gpu-blade-abc123
  Status:    running
  GPU:       NVIDIA L40S (48 GB VRAM)
  IP:        145.239.12.87
  Uptime:    2h 47m
  Remaining: 13m
  ⚠ Teardown in less than 15 minutes. Save your work.

Blades are automatically torn down when the event ends. You will see a 15-minute warning. Make sure to download your results before teardown.

rb blade config

Output an SSH config block for use with external tools.

Synopsis

rb blade config [BLADE_ID] [--append]

Description

Generates an SSH config entry that enables connecting to the blade using standard SSH tools — VS Code Remote-SSH, JetBrains Gateway, scp, rsync, or plain ssh.

Options

BLADE_ID — optional blade identifier. Defaults to the most recent running blade.
--append — write the config directly to ~/.ssh/config instead of printing to stdout.

Example

$ rb blade config
# razorBridge blade: gpu-blade-abc123
Host gpu-blade-abc123
    HostName 145.239.12.87
    User student
    IdentityFile ~/.rb/keys/gpu-blade-abc123
    StrictHostKeyChecking no

$ rb blade config --append
✓ Added gpu-blade-abc123 to ~/.ssh/config
  Connect with: ssh gpu-blade-abc123

After running rb blade config --append, open VS Code, press Cmd+Shift+P, type “Remote-SSH: Connect to Host”, and select your blade.

Transferring files

Once you have added the SSH config alias with rb blade config --append, transfer files with standard scp or rsync — no extra tooling required.

Upload examples

# Upload a single file
$ scp ./notebook.ipynb gpu-blade-abc123:~/
notebook.ipynb                          100%   24KB   2.1MB/s   00:00

# Upload a directory
$ scp -r ./data/ gpu-blade-abc123:~/data/
...

Download examples

# Download a directory
$ scp -r gpu-blade-abc123:~/results/ ./
...

# Sync a large output directory (resumable)
$ rsync -avP gpu-blade-abc123:~/outputs/ ./outputs/

rsync is recommended for large or interrupted transfers — it resumes where it left off. Both tools use the same gpu-blade-<id> host alias created by rb blade config.

rb credits

Show your current credit balance and a summary of recent transactions. Credits are consumed by GPU Blade runtime and Inference Gate usage.

Synopsis

rb credits

Example

$ rb credits
Balance: €42.50
  Recent:
  -€3.12   gpu-blade-abc123 runtime (1h)
  +€10.00  signup grant

Add --json for machine-readable output (rb --json credits). You can also view your balance in the Hub under Billing.