context list use delete

Context list / use / current / delete / set-runtime

The read-side and switch-side subcommands for the context model. These don't change context fields themselves — for that see context add, context init, or context update.

noetl context list

List every configured context. Marks the current one.

noetl context list

Example output:

CURRENT  NAME      SERVER_URL                       RUNTIME      AUTH0
*        gke-prod  https://gateway.acme.com         distributed  acme.us.auth0.com
         gke-pf    http://127.0.0.1:18082           distributed  acme.us.auth0.com
         local     http://localhost:8082            local        (none)

noetl context current

Show the current context's details, including whether a gateway session token is cached and which kube_* fields are set.

noetl context current

Example output:

Current context: gke-prod
  Server URL: https://gateway.acme.com
  Runtime:    distributed
  Auth0:      acme.us.auth0.com
  Audience:   (none)
  Token:      cached
  Kube ctx:   gke_acme_us-central1_prod
  Kube ns:    noetl

If no context is current, the CLI says so:

No current context set.

noetl context use <name>

Switch the current context. Persists across shell sessions (it updates ~/.noetl/config.toml).

noetl context use gke-prod

For a one-off command that uses a different context without changing the current one, see noetl --context <name>.

noetl context delete <name>

Remove a context from the config file. If you delete the current context, no context will be current until you context use another one (or pass --context per command).

noetl context delete old-staging

Notes:

• Does not stop a managed port-forward daemon for the context. Run noetl context port-forward <name> --stop first if one is running, otherwise the daemon will outlive the context until you kill it manually.
• Does not remove the PID file at ~/.noetl/port-forwards/<name>.pid if one is left behind by a prior daemon.

noetl context set-runtime <mode>

Set the default runtime mode for the current context.

noetl context set-runtime local
noetl context set-runtime distributed
noetl context set-runtime auto

Same effect as noetl context update <current> --runtime=<mode>, but shorter. Per-command --runtime flags override this.

See also

• Context model — what each field means.
• context add, context init, context update — write-side commands.
• Global flags — --context <name> for one command at a time.