shc ctx
manage CLI contexts
Reference for the ctx CLI group. Source: modules/ctx/commands/.
Running shc ctx with no subcommand inspects or updates the active context. The flags below set fields on it; with no flags it prints the resolved context.
| Flag | Type | Required | Help |
|---|---|---|---|
-t / --tenant | str | no | set tenant |
-s / --stack | str | no | set stack |
-e / --environment | str | no | set environment |
--cluster | str | no | set active cluster |
--reset | bool | no | reset context to defaults |
Subcommands
Section titled “Subcommands”| Subcommand | Description |
|---|---|
login | register a cluster and persist its access token |
logout | clear the token from a context |
shc ctx login <name>
Section titled “shc ctx login <name>”register a cluster and persist its access token
| Flag | Type | Required | Help |
|---|---|---|---|
--url | str | yes | cluster URL (https://…) |
--token | str | no | auth token (raw bearer JWT) |
--token-exec | str | no | shell command that prints a fresh token to stdout each call |
--insecure | bool | no | skip TLS verification |
--ca | str | no | path to a CA bundle for TLS verification |
--color | int | no | pin the HUD background tint (palette index 0-8; 0 = neutral) |
Source: modules/ctx/commands/
shc ctx logout [name]
Section titled “shc ctx logout [name]”clear the token from a context
The optional positional [name] selects the context; it defaults to the active cluster.
Source: modules/ctx/commands/
shc@docs:~$