idyl context - IDYL Docs

View and manage saved contexts. A context is a named configuration that defines the Network, identity, account, profile, entered Namespace, and subnet for CLI commands. Contexts let you switch between environments without re-authenticating.

Usage

idyl context

Aliases

contexts
ctx

Commands

Command	Description
`idyl context create`	Create a new context
`idyl context delete`	Delete a context
`idyl context edit`	Edit a context
`idyl context get`	Get context details or list all contexts
`idyl context show`	Show current context
`idyl context use`	Switch to a different 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 address, overriding the entered context.
`--network <string>`	Override the Network for this command.
`-p <string>, --profile <string>`	Override the access profile for this command.
`-s <string>, --subnet <string>`	Subnet to use for this command, overriding the current context.

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 acme-corp/staging --profile Developer

# Switch the active context
idyl context use staging

# Edit the current context
idyl context edit --set-subnet 550000000002 --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 Network, 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

Flag	Description
`--account <string>`	Account in org/name format, such as acme-corp/staging.
`--profile <string>`	Access profile name.
`--set-namespace <string>`	Namespace the new context enters. Default: `default`.
`--use`	Set the new context as the 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 \
  --set-namespace production

# 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

Flag	Description
`--force`	Delete the context even if it is the 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. Editing a context does not validate the Namespace against the platform. Use ‘idyl use’ to enter a Namespace that is checked as it is entered.

Usage

idyl context edit [flags]

Flags

Flag	Description
`--set-namespace <string>`	Set the entered Namespace.
`--set-subnet <string>`	Set the subnet.

Examples

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

# Enter a Namespace
idyl context edit --set-namespace production

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

`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

`idyl context use`

Switch the active context. A context carries the Network, identity, account, profile, entered Namespace, and subnet. Switching contexts changes all of them at once; to move within the current context, use ‘idyl use’. With no argument, an interactive selector lists the saved contexts. When switching, the access token is refreshed if needed.

Usage

idyl context use [name]

Examples

# Interactive context selection
idyl context use

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

​Usage

​Aliases

​Commands

​Inherited flags

​Examples

​Subcommand reference

​idyl context create

​Usage

​Flags

​Examples

​idyl context delete

​Usage

​Aliases

​Flags

​Examples

​idyl context edit

​Usage

​Flags

​Examples

​idyl context get

​Usage

​Aliases

​Examples

​idyl context show

​Usage

​Examples

​idyl context use

​Usage

​Examples

Usage

Aliases

Commands

Inherited flags

Examples

Subcommand reference

`idyl context create`

Usage

Flags

Examples

`idyl context delete`

Usage

Aliases

Flags

Examples

`idyl context edit`

Usage

Flags

Examples

`idyl context get`

Usage

Aliases

Examples

`idyl context show`

Usage

Examples

`idyl context use`

Usage

Examples