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 workspaces and namespaces

idyl namespace create production
idyl use production
idyl workspace list
idyl workspace create payments
idyl use production/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 Runs

idyl workspace create <workspace> --namespace <namespace>
idyl use <namespace>/<workspace>
idyl file put src/main.py ./main.py
idyl run create --image python:3.13 -- python /workspace/src/main.py
idyl run list

Use idyl run logs <run-id> to read the latest attempt’s logs or idyl run shell <run-id> to open a shell in it.

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 workspaces and namespaces

​Deploy and inspect a workload

​Scale a deployment

​Apply a manifest

​Work with durable files and Runs

​Inspect subnets and nodes

​Join and name provider capacity