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

> Switch to a different context

Switch to a saved context.

The use command provides two ways to switch your active context:

1. Interactive mode (no arguments):
   idyl use

   Shows a list of all saved contexts with an interactive selector.
   Use arrow keys to navigate and Enter to select.

2. Direct mode (with argument):
   idyl use prod-dev

   Switches directly to the named context.

When switching contexts, the access token is automatically refreshed if needed.

## Usage

```bash theme={null}
idyl use [context]
```

## 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}
# Interactive context selection
idyl use

# Switch to a specific context
idyl use prod-dev
idyl use staging
```