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

# idyl namespace

> Manage namespaces in your account

View and manage namespaces within your account.

Namespaces provide logical isolation for resources within an account.
Each account has a 'default' namespace that cannot be deleted.

## Usage

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

## Aliases

* `namespaces`
* `ns`

## Commands

| Command                 | Description                                  |
| ----------------------- | -------------------------------------------- |
| `idyl namespace create` | Create a new namespace                       |
| `idyl namespace delete` | Delete a namespace                           |
| `idyl namespace edit`   | Edit a namespace                             |
| `idyl namespace get`    | Get namespace details or list all namespaces |
| `idyl namespace show`   | Show current namespace details               |

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

## Examples

```bash theme={null}
# List namespaces
idyl namespace list

# Create a new namespace
idyl namespace create my-namespace

# Get namespace details
idyl ns get my-namespace

# Edit a namespace
idyl ns edit my-namespace --set-description "Updated description"

# Delete a namespace
idyl namespace delete my-namespace
```

## Subcommand reference

### `idyl namespace create`

Create a new namespace in your account.

Namespace names must be lowercase alphanumeric with hyphens, between 1-63 characters.

#### Usage

```bash theme={null}
idyl namespace create <name> [flags]
```

#### Flags

| Flag                             | Description                                            |
| -------------------------------- | ------------------------------------------------------ |
| `--description <string>`         | Description of the namespace.                          |
| `-o <string>, --output <string>` | Output format: table, json, or yaml. Default: `table`. |

#### Examples

```bash theme={null}
# Create a namespace
idyl namespace create my-namespace

# Create with description
idyl ns create my-namespace --description "Production environment"
```

### `idyl namespace delete`

Delete a namespace from your account.

The 'default' namespace cannot be deleted.

You will be prompted for confirmation unless the --yes flag is provided.

#### Usage

```bash theme={null}
idyl namespace delete <name> [flags]
```

#### Flags

| Flag        | Description                |
| ----------- | -------------------------- |
| `-y, --yes` | Skip confirmation prompts. |

#### Examples

```bash theme={null}
# Delete a namespace (with confirmation)
idyl namespace delete my-namespace

# Delete without confirmation
idyl ns delete my-namespace --yes
```

### `idyl namespace edit`

Edit a namespace's settings.

#### Usage

```bash theme={null}
idyl namespace edit <name> [flags]
```

#### Flags

| Flag                             | Description                                            |
| -------------------------------- | ------------------------------------------------------ |
| `-o <string>, --output <string>` | Output format: table, json, or yaml. Default: `table`. |
| `--set-description <string>`     | Set the namespace description.                         |

#### Examples

```bash theme={null}
# Update description
idyl namespace edit my-namespace --set-description "New description"
```

### `idyl namespace get`

Get details of a specific namespace, or list all namespaces in your account.

With no arguments, lists all namespaces.
With a name argument, gets details of that specific namespace.

#### Usage

```bash theme={null}
idyl namespace get [name] [flags]
```

#### Aliases

* `list`
* `ls`

#### Flags

| Flag                             | Description                                            |
| -------------------------------- | ------------------------------------------------------ |
| `--limit <int>`                  | Maximum number of namespaces to list. Default: `20`.   |
| `--offset <int>`                 | Number of namespaces to skip. Default: `0`.            |
| `-o <string>, --output <string>` | Output format: table, json, or yaml. Default: `table`. |

#### Examples

```bash theme={null}
# List namespaces
idyl namespace get

# Get namespace details
idyl namespace get my-namespace

# Get in JSON format
idyl ns get my-namespace -o json
```

### `idyl namespace show`

Show details of the current namespace from the active context.

Respects --namespace, --account-id, and --context flags.

#### Usage

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

#### Flags

| Flag                             | Description                                            |
| -------------------------------- | ------------------------------------------------------ |
| `-o <string>, --output <string>` | Output format: table, json, or yaml. Default: `table`. |

#### Examples

```bash theme={null}
# Show current namespace details
idyl namespace show

# Show a specific namespace
idyl namespace show -n my-namespace

# Show current namespace in JSON format
idyl ns show -o json
```