Skip to main content
razi shell opens a live interactive PTY shell into your team’s VM. It works like SSH: keystrokes go in, output comes back, and terminal resizing is forwarded automatically.

​
Prerequisites

  • The razi CLI installed and configured. Run razi setup if you haven’t authenticated yet.
  • An active team. The team must finish provisioning before it can accept a shell connection.

​
List your teams

Run razi shell with no arguments to see all teams on your account along with their current status:
Example output:
● in green means the team is active and shellable. Other statuses appear in dim text to indicate the team is not yet ready.
Only active teams can accept a shell connection. If your team is still provisioning, wait for it to finish and then try again.

​
Connect to a team

Pass the team slug as the first argument:
The CLI authenticates using your stored account key, retrieves a per-team shell key, and opens a WebSocket to the VM. Once connected, you see:
Your terminal is now in raw mode and you have a full PTY inside the VM.

​
Partial slug matching

If the slug is unambiguous, you can use a prefix or substring:
This matches blue-fox-1234 if no other team slug contains blue. The match order is: exact slug, then exact display name, then case-insensitive slug. If the short form is ambiguous, the CLI reports an error and lists your teams.
You can also pass the team’s display name directly: razi shell "My first team".

​
Exit the shell

Type exit or press Ctrl-D to close the session. The WebSocket closes cleanly and your terminal is restored to normal mode.

​
Status reference