Skip to content
Developer Documentation
LlamaAgents
llamactl Reference
environments

environments

Manage environments (distinct control plane API URLs). Environments determine which profiles are shown and where auth/project actions apply.

Usage

Section titled “Usage”
Terminal window
llamactl environments [COMMAND] [options]

Commands:

  • get [API_URL] [-o text|json|yaml]: List environments or show one environment
  • add <API_URL>: Probe the server and upsert the environment
  • use [API_URL]: Select the current environment; prompts if omitted in interactive mode
  • delete [API_URL]: Remove an environment and its associated profiles

Notes:

  • Probing reads requires_auth and min_llamactl_version from the server version endpoint.
  • Switching environment filters profiles shown by llamactl auth get and used by other commands.

Commands

Section titled “Commands”

Get

Section titled “Get”
Terminal window
llamactl environments get [API_URL]

Shows a table of environments with API URL, whether auth is required, and the active environment. Pass API_URL to show one environment.

Add

Section titled “Add”
Terminal window
llamactl environments add <API_URL>

Probes the server at <API_URL> and stores discovered settings. Interactive mode can prompt for the URL.

Use

Section titled “Use”
Terminal window
llamactl environments use [API_URL]

Sets the current environment. If omitted in interactive mode, you’ll be prompted to select one.

Delete

Section titled “Delete”
Terminal window
llamactl environments delete [API_URL]

Deletes an environment and all associated profiles. If the deleted environment was current, the current environment is reset to the default.

See also

Section titled “See also”