> ## Documentation Index
> Fetch the complete documentation index at: https://docs.idyl.network/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI examples

> Common command sequences for IDYL CLI workflows.

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

## Set context

```bash theme={null}
idyl login
idyl whoami
idyl context edit --set-namespace <namespace>
idyl context edit --set-subnet <subnet>
```

## Deploy and inspect a workload

```bash theme={null}
idyl deploy nginx:1.25 --name web --replicas 2
idyl get deployment web
idyl get all
```

## Scale a deployment

```bash theme={null}
idyl scale deployment web --replicas 3
idyl get deployment web
```

## Apply a manifest

```bash theme={null}
idyl apply -f app.yaml
```

## Inspect subnets and nodes

```bash theme={null}
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:

```bash theme={null}
idyl node join --fleet <fleet-id> --display-name gpu-1 --start
```

Rename this machine's existing local node identity:

```bash theme={null}
idyl node edit --set-display-name gpu-2
```

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

```bash theme={null}
idyl node edit <node-id> --set-display-name gpu-2
idyl fleet list-nodes --fleet <fleet-id>
```

Clear the display name:

```bash theme={null}
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](/build), [Operate](/operate), or [Provide](/provide). For exact syntax, use the [command reference](/cli/reference/generated).