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

# Command reference

> Exact syntax, arguments, flags, aliases, and output options for IDYL CLI commands.

Use this reference when you need exact command syntax. For CLI setup and usage concepts, start with the [CLI user guide](/cli).

## Notation

| Notation            | Meaning                                 |
| ------------------- | --------------------------------------- |
| `<value>`           | Required value.                         |
| `[value]`           | Optional value.                         |
| `[flags]`           | Optional flags accepted by the command. |
| `-n`, `--namespace` | Short and long forms of the same flag.  |
| `KEY=VALUE`         | Literal key-value format.               |

## Usage

```bash theme={null}
idyl [flags]
```

## Global flags

| Flag                                 | Description                                                        |
| ------------------------------------ | ------------------------------------------------------------------ |
| `-a <string>, --account-id <string>` | Account ID to use, overriding the current context.                 |
| `-c <string>, --context <string>`    | Use the named context for this command.                            |
| `-h, --help`                         | Show help for a command.                                           |
| `--homedir <string>`                 | Override the configuration directory. Defaults to \~/.config/idyl. |
| `-n <string>, --namespace <string>`  | Namespace to use for this command.                                 |
| `-o <string>, --output <string>`     | Output format (json\|yaml).                                        |
| `-p <string>, --profile <string>`    | Override the access profile for this command.                      |
| `--realm <string>`                   | Override the realm for this command.                               |
| `--subnet <string>`                  | Override the context subnet for this command.                      |

## Commands

### Deploy

| Command                                          | Description                                   |
| ------------------------------------------------ | --------------------------------------------- |
| [`idyl apply`](/cli/reference/generated/apply)   | Apply resource manifests from a file          |
| [`idyl deploy`](/cli/reference/generated/deploy) | Deploy an application from the command line   |
| [`idyl run`](/cli/reference/generated/run)       | Run a standalone pod for debugging or testing |

### Manage Workloads

| Command                                            | Description                            |
| -------------------------------------------------- | -------------------------------------- |
| [`idyl create`](/cli/reference/generated/create)   | Create a resource                      |
| [`idyl delete`](/cli/reference/generated/delete)   | Delete resources                       |
| [`idyl edit`](/cli/reference/generated/edit)       | Edit a resource                        |
| [`idyl get`](/cli/reference/generated/get)         | List and inspect resources             |
| [`idyl scale`](/cli/reference/generated/scale)     | Change the replica count of a workload |
| [`idyl trigger`](/cli/reference/generated/trigger) | Manually trigger a resource            |
| [`idyl wait`](/cli/reference/generated/wait)       | Wait for a workload resource condition |

### Debug

| Command                                        | Description                                       |
| ---------------------------------------------- | ------------------------------------------------- |
| [`idyl exec`](/cli/reference/generated/exec)   | Run a command in a workload container             |
| [`idyl logs`](/cli/reference/generated/logs)   | Show logs from a workload container               |
| [`idyl shell`](/cli/reference/generated/shell) | Open an interactive shell in a workload container |

### Infrastructure

| Command                                          | Description             |
| ------------------------------------------------ | ----------------------- |
| [`idyl fleet`](/cli/reference/generated/fleet)   | Manage provider fleets  |
| [`idyl node`](/cli/reference/generated/node)     | Manage nodes            |
| [`idyl region`](/cli/reference/generated/region) | View and manage regions |
| [`idyl subnet`](/cli/reference/generated/subnet) | Manage subnets          |

### Account & Access

| Command                                                | Description                       |
| ------------------------------------------------------ | --------------------------------- |
| [`idyl account`](/cli/reference/generated/account)     | Manage your account               |
| [`idyl iam`](/cli/reference/generated/iam)             | Manage identity and access        |
| [`idyl namespace`](/cli/reference/generated/namespace) | Manage namespaces in your account |
| [`idyl org`](/cli/reference/generated/org)             | Manage organizations              |

### Auth & Context

| Command                                            | Description                         |
| -------------------------------------------------- | ----------------------------------- |
| [`idyl context`](/cli/reference/generated/context) | Manage saved contexts               |
| [`idyl init`](/cli/reference/generated/init)       | Initialize the IDYL CLI for a realm |
| [`idyl login`](/cli/reference/generated/login)     | Authenticate with IDYL              |
| [`idyl logout`](/cli/reference/generated/logout)   | Log out from IDYL                   |
| [`idyl profile`](/cli/reference/generated/profile) | View your access profiles           |
| [`idyl signup`](/cli/reference/generated/signup)   | Create a new IDYL account           |
| [`idyl use`](/cli/reference/generated/use)         | Switch to a different context       |
| [`idyl whoami`](/cli/reference/generated/whoami)   | Show current identity and context   |

### System

| Command                                            | Description               |
| -------------------------------------------------- | ------------------------- |
| [`idyl update`](/cli/reference/generated/update)   | Check for CLI updates     |
| [`idyl version`](/cli/reference/generated/version) | Print version information |