Namespace Commands¶

The namespace command allows you to view, switch, and manage Kubernetes namespaces.

Usage¶

k8stool namespace [namespace_name]    # Long form
k8stool ns [namespace_name]          # Short form

Available Commands¶

Show Current Namespace¶

k8stool ns
k8stool ns current

Shows the currently active namespace.

List Namespaces¶

k8stool ns list
k8stool ns ls

Lists all available namespaces with their status. Output includes: - Namespace name - Status - Active status (*)

Switch Namespace¶

Direct switch (multiple formats):

k8stool ns <namespace-name>           # Direct switch (new shorthand)
k8stool ns switch <namespace-name>    # Using switch subcommand

Switch to a different namespace directly. The command will validate that the namespace exists before switching.

Interactive switch:

k8stool ns -i                  # Interactive shorthand
k8stool ns switch             # Interactive with switch subcommand
k8stool ns switch -i          # Interactive with flag

Opens an interactive menu to select and switch namespaces. Features: - Shows current namespace with "(current)" suffix - Uses colored output for better visibility - Shows 10 namespaces at a time - Uses emoji indicators for selection

Interactive Mode Features¶

The interactive mode provides: 1. List of all available namespaces 2. Current namespace highlighted 3. Arrow key navigation 4. Enter to select namespace

Example output:

Select namespace:
  default
👉 production (current)
  kube-system
  monitoring

Output¶

The output includes: - Namespace name - Status (color-coded) - Active status (*)

Example output when showing current namespace:

Current namespace: production

Example output when switching namespace:

Switched to namespace "production"

Example error when namespace doesn't exist:

Error: namespaces "nonexistent" not found

Context: Manage context selection