Skip to main content
View and manage saved contexts. A context is a named configuration that defines the realm, identity, account, profile, namespace, and subnet for CLI commands. Contexts allow you to quickly switch between different environments without re-authenticating.

​
Usage

idyl context

​
Aliases

  • contexts
  • ctx

​
Commands

CommandDescription
idyl context createCreate a new context
idyl context deleteDelete a context
idyl context editEdit a context
idyl context getGet context details or list all contexts
idyl context showShow current context

​
Inherited flags

FlagDescription
-a <string>, --account-id <string>Account ID to use (overrides context)
-c <string>, --context <string>Use specific context
--homedir <string>Override config directory (default: ~/.idyl)
-n <string>, --namespace <string>Namespace to use
-o <string>, --output <string>Output format (json|yaml)
-p <string>, --profile <string>Override profile
--realm <string>Override realm
--subnet <string>Override context subnet for this command

​
Examples

# Show current context
idyl context show

# Get details of a specific context
idyl context get staging

# List all saved contexts
idyl context list

# Create a new context
idyl context create staging --account-id 550000000001 --profile Developer

# Edit the current context
idyl context edit --set-subnet my-subnet --set-namespace production

# Delete a context
idyl context delete old-context

​
Subcommand reference

​
idyl context create

Create a new context by selecting an account and profile. A context stores all the configuration needed to interact with an Idyl realm, including identity, account, profile, namespace, and subnet settings. When run without arguments, the command enters interactive mode and prompts you to select an account and profile from available options.

​
Usage

idyl context create [name] [flags]

​
Flags

FlagDescription
--account-id <string>Account ID (12-digit public ID)
--namespace <string>Namespace Default: default.
--profile <string>Access profile name
--subnet <string>Subnet for workload placement
--useSet as current context after creation

​
Examples

# Interactive mode (prompts for all selections)
idyl context create

# Create with explicit name
idyl context create staging

# Create with explicit account and profile
idyl context create staging \
  --account acme-corp/staging \
  --profile Developer \
  --namespace api

# Create and switch to the new context
idyl context create mydev \
  --account [email protected]/myproject \
  --profile Owner \
  --use

​
idyl context delete

Delete a context by name. By default, the current context cannot be deleted. Use —force to override.

​
Usage

idyl context delete <name> [flags]

​
Aliases

  • rm

​
Flags

FlagDescription
--forceForce delete even if current context

​
Examples

# Delete a context
idyl context delete old-context

# Force delete the current context
idyl context delete current-context --force

​
idyl context edit

Edit settings on the current context, or a specific context with —context. Only the specified flags are updated; other settings remain unchanged.

​
Usage

idyl context edit [flags]

​
Flags

FlagDescription
--set-namespace <string>Set the namespace
--set-subnet <string>Set the subnet

​
Examples

# Set the subnet on the current context
idyl context edit --set-subnet my-subnet

# Set the namespace on the current context
idyl context edit --set-namespace production

# Edit a different context without switching to it
idyl context edit --context staging --set-subnet my-subnet

# Set both at once
idyl context edit --set-subnet my-subnet --set-namespace production

​
idyl context get

Get details of a specific context, or list all saved contexts. With no arguments, lists all contexts. With a name argument, shows details of that specific context.

​
Usage

idyl context get [name]

​
Aliases

  • list
  • ls

​
Examples

# List all saved contexts
idyl context get

# Get details of a specific context
idyl context get staging

​
idyl context show

Show details of the current active context.

​
Usage

idyl context show

​
Examples

# Show current context
idyl context show