Skip to main content
Everything in GRID starts from the grid CLI — an interactive shell that onboards robots, starts simulator and robot sessions, and deploys programs.

​
1. Install the CLI

Your organization’s GRID admin portal shows this same command on its Welcome screen, pre-filled with your cluster:
Prefer the portal variant — it registers your cluster so login connects to the right place immediately. (Windows support is coming soon; use WSL in the meantime.) The installer verifies a signed binary, installs it to ~/.grid/bin/grid, adds it to your PATH, and offers the GRID Studio VS Code extension. Open a new terminal and run:

​
2. Log in

Inside the shell, authenticate with your browser:
Your tokens are stored per cluster; switch changes the active cluster if your organization has more than one.

​
3. Get your Cortex API key

Cloud model inference (detection, depth, grasping, VLAs) is authenticated by a separate runtime key. Generate it in the admin portal (the same site that showed your install command — ask your org admin for its URL if you don’t have it), and paste it when robot add asks — the CLI persists it for every later session.

​
4. Onboard a robot

The wizard walks you through connecting your robot to the GRID network. Once added, it shows up for everyone in your organization:

​
5. Start working

Pick sim for a cloud simulator session (opens a browser workspace with a live scene), or robot to open a VS Code workspace wired to your physical robot — a notebook with a live robot connection, ready for code.

​
Where next

Related topics

OverviewGRID Cortex ClientYour first sessionYour first skillThe Intelligence Grid for Physical AI