Start here

Create your first computer

Build the local CLI, connect it to the API, and run a command on provider-neutral compute.

Build the CLI

tctl is local-only during the developer preview. Build it from the repository root with Go 1.24 or newer.

Terminal

make cli
./bin/tctl --help

Connect

Point the CLI at the production API and save a bearer token in your local context. The token is never part of the command history when supplied through an environment variable.

Terminal

export T_API_TOKEN="<your-token>"
./bin/tctl context set \
  --server https://api.t.computer \
  --token "$T_API_TOKEN"

./bin/tctl status

Create a computer

A computer describes a surface and capabilities, not a vendor. Start with a sandbox and let the router select available capacity.

Terminal

./bin/tctl create \
  --name first-computer \
  --surface sandbox \
  --image ubuntu:24.04

Run a command

Use the returned computer ID to run a short diagnostic command. Release the computer when you are done.

Terminal

./bin/tctl exec cmp_01... -- uname -a
./bin/tctl stop cmp_01...

Next, learn how routing and trust shape where a computer runs.