context)¶

A kubectx-style workflow for EKS. Save named contexts that bind a cluster to an optional region and AWS profile, then switch between them by name instead of repeating --cluster/--region/--profile on every command.

refresh use <name>          # switch the active context
refresh current             # print the active context
refresh context add|list|remove [args] [flags]

The active context fills in cluster/region/profile defaults for every command. Per-invocation flags still override it. For the conceptual overview see Contexts; this page is the command-reference detail.

Where contexts are stored

Contexts are saved as YAML under $XDG_CONFIG_HOME/refresh/context.yaml (default ~/.config/refresh/context.yaml). The REFRESH_CONTEXT env var overrides the saved "current" pointer for a single shell.

refresh use¶

Switch the active context so subsequent commands inherit its cluster, region, and profile.

refresh use [context-name|-]

refresh use prod — make prod active.
refresh use - — toggle back to the previously active context.
refresh use — no name: pick interactively from the saved list.

Per-invocation --region/--profile/--cluster flags still override the active context.

refresh use prod
refresh use -

refresh current¶

Print the name and cluster/region/profile of the currently active context. Honors the REFRESH_CONTEXT override, and prints a hint when no context is active.

refresh current

refresh context¶

Manage the named contexts that refresh use switches between. The group has the alias ctx.

refresh context <list|add|remove> [args] [flags]

context list¶

List every saved context with its cluster, region, and profile. The active context is marked with a *. Aliased as ls.

refresh context list

context add¶

Create or overwrite a named context. Re-running with the same name updates it in place.

refresh context add <name> --cluster <cluster> [flags]

Flag	Description
`--cluster, -c`	Required. EKS cluster name
`--region, -r`	AWS region (optional)
`--profile, -p`	AWS shared-config profile (optional)
`--use`	Switch to this context immediately after saving

refresh context add prod --cluster prod-eks --region us-east-1 --profile prod
refresh context add stage --cluster stage-eks --region us-west-2 --profile stage

# Add and switch in one step
refresh context add prod --cluster prod-eks --use

context remove¶

Delete a saved context by name. If the removed context was the active or previous one, those pointers are cleared. Aliased as rm / delete.

refresh context remove prod

Typical workflow¶

# Define your environments once
refresh context add prod  --cluster prod-eks  --region us-east-1 --profile prod
refresh context add stage --cluster stage-eks --region us-west-2 --profile stage

# Switch, then run commands with no repeated flags
refresh use prod
refresh nodegroup list          # targets prod-eks / us-east-1 / prod
refresh cluster upgrade-check   # same context

refresh use stage               # flip the whole environment