> ## 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.

# Get started with the CLI

> Install the CLI, authenticate, inspect your context, and choose a workflow.

Use this page when you have IDYL access and want to start from the terminal.

## 1. Install the CLI

Choose the install path for your operating system.

<Tabs>
  <Tab title="macOS">
    Add the IDYL Homebrew tap, then install the CLI:

    ```bash theme={null}
    brew tap idyl-labs/tap
    brew install --cask idyl-labs/tap/idyl
    ```

    You can also use the install script:

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/idyl-labs/cli/main/install.sh | sh
    ```
  </Tab>

  <Tab title="Linux">
    Install with the install script:

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/idyl-labs/cli/main/install.sh | sh
    ```
  </Tab>

  <Tab title="Windows">
    Add the IDYL Scoop bucket, then install the CLI:

    ```powershell theme={null}
    scoop bucket add idyl https://github.com/idyl-labs/scoop-bucket
    scoop install idyl
    ```
  </Tab>
</Tabs>

Verify the installation:

```bash theme={null}
idyl version
```

## 2. Log in

```bash theme={null}
idyl login
```

The CLI authenticates your session and saves the context used by later commands.

## 3. Check the active context

```bash theme={null}
idyl whoami
```

Review the active account, profile, namespace, and subnet before running commands that create or change resources.

## 4. Select a namespace and subnet

If the active values are not the ones you want to use, update the context:

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

Commands that accept `--namespace` or `--subnet` can also override the saved context for one command.

## 5. Choose a workflow

<Columns cols={2}>
  <Card title="Deploy a workload" href="/build/deploy-a-workload">
    Create a deployment or job from a container image.
  </Card>

  <Card title="Use a manifest" href="/build/use-a-manifest">
    Create or update resources from YAML.
  </Card>

  <Card title="Manage a subnet" href="/operate/manage-a-subnet">
    Create, inspect, update, and delete subnets.
  </Card>

  <Card title="Connect capacity" href="/provide/connect-a-node">
    Add a node to a subnet.
  </Card>
</Columns>

For exact syntax, use the [command reference](/cli/reference/generated).