CLI examples - IDYL Docs

Use these examples as starting points. Replace values in angle brackets before running a command.

Set context

idyl login
idyl whoami
idyl use <namespace>
idyl context edit --set-subnet <subnet>

Work with computers and namespaces

idyl namespace create production
idyl use production
idyl computer list
idyl computer create payments

Deploy and inspect a workload

idyl deploy nginx:1.25 --name web --replicas 2
idyl get deployment web
idyl get all

Scale a deployment

idyl scale deployment web --replicas 3
idyl get deployment web

Apply a manifest

idyl apply -f app.yaml

Work with durable files and execution history

idyl computer create <computer> --namespace <namespace> --subnet <subnet> --image-ref python:3.13
idyl computer cp ./main.py <computer>:src/main.py --namespace <namespace> --subnet <subnet>
idyl computer exec <computer> --namespace <namespace> --subnet <subnet> -- python /workspace/src/main.py
idyl computer history <computer> --namespace <namespace> --subnet <subnet>

Use idyl computer ssh <computer> to open a shell. Saved versions can be inspected with idyl computer versions <computer>, rewound with go-back, or copied into a new Computer with fork.

Inspect subnets and nodes

idyl subnet get
idyl subnet show
idyl node get

Join and name provider capacity

Join this machine through a fleet with an optional display name:

idyl node join --fleet <fleet-id> --display-name gpu-1 --start

Rename this machine’s existing local node identity:

idyl node edit --set-display-name gpu-2

Rename a specific node by canonical node ID, then list the fleet membership:

idyl node edit <node-id> --set-display-name gpu-2
idyl fleet list-nodes --fleet <fleet-id>

Clear the display name:

idyl node edit <node-id> --clear-display-name

Display names are labels only. Continue to use the node ID for commands, admission, and workload placement. For task-led guidance, use Build, Operate, or Provide. For exact syntax, use the command reference.

​Set context

​Work with computers and namespaces

​Deploy and inspect a workload

​Scale a deployment

​Apply a manifest

​Work with durable files and execution history

​Inspect subnets and nodes

​Join and name provider capacity