​
Overview

Compare your local workspace storage with server workspaces to identify sync issues and provide actionable guidance for resolution.

​
Syntax

ntcli workspace sync [options]

​
Aliases

ntcli ws sync    # Command group alias

​
Examples

​
Basic Sync Check

ntcli workspace sync
Sample Output: 
📊 Sync Summary
  Server workspaces: 2
  Local workspaces: 1
  In sync: 1
  On server only: 1
  Local only: 0

⚠️  Workspaces on server but not locally:
  production-workspace (a1b2c3d4-...)

   💡 To use these workspaces, you need to get access tokens:
   💡 `ntcli token refresh <workspace-name>`

​
Command Group Alias

ntcli ws sync

​
Use Cases

​
Identifying Missing Workspaces

When you have access to workspaces on the server but they don’t appear locally: 
# Check sync status
ntcli workspace sync

# Get access token for server-only workspaces
ntcli token refresh production-workspace

# Verify workspace is now available locally
ntcli workspace list

​
Troubleshooting Workspace Access

When experiencing workspace-related issues: 
# Check overall sync status
ntcli ws sync

# Debug detailed workspace information
ntcli ws debug

# Fix any identified issues
ntcli token refresh <workspace-name>

​
Output Format

The command provides structured output with:
  • 📊 Sync Summary: Overview of workspace counts
  • ⚠️ Workspaces on server only: Lists missing workspaces with IDs
  • 💡 Guidance: Specific commands to resolve sync issues

workspace debug

Debug local workspace storage files

token refresh

Refresh workspace access tokens

workspace list

List all available workspaces

workspace switch

Switch to a different workspace