​
Overview

Switch the active workspace to a different one. All subsequent commands will operate on the newly selected workspace.

​
Syntax

ntcli workspace switch <name>

​
Aliases

ntcli workspace use <name>    # Alternative command
ntcli ws switch <name>        # Command group alias  
ntcli ws use <name>           # Combined aliases

​
Arguments

​
name
string
required
Name of the workspace to switch to (must exist)

​
Options

​
-v, --verbose
boolean
Show detailed information about the workspace switch

​
Examples

​
Basic Switch

ntcli workspace switch production

​
Using Alias

ntcli workspace use production

​
Verbose Switch

ntcli workspace switch staging --verbose

ntcli workspace switch production

​
What Happens

When you switch workspaces:
  1. Active workspace changes - All commands now target the new workspace
  2. Tokens are updated - Workspace-specific access tokens are loaded
  3. Context is preserved - The switch persists across terminal sessions

workspace list

List all available workspaces

workspace select

Interactively select a workspace