Skip to main content

Roboticks CLI

The Roboticks CLI (rbtk) is your command-line interface for managing robot fleets, deploying software, running tests, and automating workflows. It’s designed for both interactive local development and CI/CD automation.

Key Features

Fleet Management

List devices, view status, manage groups, and organize your fleet

Software Deployment

Upload capsules, create packages, and roll out updates to devices

Testing

Run simulation tests on cloud runners and watch progress in real-time

CI/CD Ready

Non-interactive mode with API keys and machine-readable output

Quick Start

# Install the CLI
pip install roboticks-cli

# Login (opens browser)
rbtk login

# Set your context (org + project)
rbtk context set --org acme --project warehouse

# List your devices
rbtk device list

# Deploy software
rbtk capsule push ./build.tar.gz --name perception --version 2.1.0
rbtk rollout create --package 10 --group 5 --start

Command Categories

CategoryCommandsDescription
Authlogin, logout, auth statusAuthentication and credentials
Contextcontext set, context listOrganization and project selection
Devicesdevice list, device getFleet device management
Capsulescapsule push, capsule listSoftware package uploads
Packagespackage create, package activateDeployment packages
Rolloutsrollout create, rollout watchSoftware deployments
Testingsimulate run, simulate watchCloud-based testing
Sessionssession list, session filesSession data and artifacts
Logslog list, log streamDevice logs and debugging
Tunnelstunnel ssh, tunnel createRemote device access

Interactive vs CI/CD Mode

The CLI automatically detects your environment:
  • Progress bars and spinners
  • Colored output
  • Interactive prompts for missing info
  • Confirmation dialogs

Next Steps