Last modified June 21, 2026
'muster context' command reference
muster context manages named contexts. Each context points at a Muster endpoint, so you can switch between a local aggregator and one or more remote management clusters without retyping URLs. Running muster context with no subcommand lists the contexts.
Usage
muster context [subcommand]
Subcommands
| Subcommand | Aliases | Description |
|---|---|---|
list | ls | List all configured contexts |
current | Show the name of the active context | |
use <name> | switch | Switch the active context |
add <name> --endpoint <url> | Add a new context | |
update <name> --endpoint <url> | set | Change an existing context’s endpoint |
rename <old-name> <new-name> | Rename a context | |
show <name> | describe, get | Show details for one context |
delete <name> | rm, remove | Delete a context |
Flags
| Subcommand | Name | Description |
|---|---|---|
add | --endpoint | Endpoint URL for the context (required) |
add | --use | Set as the active context after adding |
update | --endpoint | New endpoint URL (required) |
show | --output, -o | Output format: text (default), json, or yaml |
delete | --force, -f | Skip the confirmation prompt |
| (all) | --quiet, -q | Suppress non-essential output |
Examples
Add a context for a remote management cluster and make it active:
muster context add prod \
--endpoint https://muster.<management-cluster>.<base-domain>/mcp --use
Switch back to a local aggregator:
muster context use local
Related
muster auth- Authenticate to the endpoint behind a context.
Need help, got feedback?
We listen to your Slack support channel. You can also reach us at support@giantswarm.io. And of course, we welcome your pull requests!