​
Overview

Debug local workspace storage files to diagnose workspace and authentication issues. Shows detailed information about configuration files, token status, and storage health.

​
Syntax

ntcli workspace debug [options]

​
Aliases

ntcli ws debug    # Command group alias

​
Options

​
-v, --verbose
boolean
Show full file contents for detailed debugging

​
Examples

​
Basic Debug Information

ntcli workspace debug
Sample Output: 
🔍 NimbleTools Configuration Debug

📁 Workspaces File:
  Path: ~/.nimbletools/workspaces.json
  Exists: ✓
  Workspaces count: 2
  Active workspace ID: ws-my-project-12345...

Individual workspaces:
  ✓ my-project (ws-my-project-12345...)
    Token expires: Valid (expires in 120 minutes)
  ✗ old-workspace (ws-old-workspace-67890...)
    Token expires: Expired (expired 2 days ago)

🔑 Auth Tokens File:
  Path: ~/.nimbletools/tokens.json
  Exists: ✓
  Valid tokens: 1
  Expired tokens: 1

👤 User Profile:
  Path: ~/.nimbletools/user.json
  Exists: ✓
  User authenticated: ✓

​
Verbose Debug Output

ntcli workspace debug --verbose
Shows complete file contents for detailed analysis.

​
Command Group Alias

ntcli ws debug

​
Storage Locations

The command inspects these configuration files:
FilePurposeLocation
workspaces.jsonWorkspace definitions and metadata~/.nimbletools/workspaces.json
tokens.jsonAuthentication tokens~/.nimbletools/tokens.json
user.jsonUser profile information~/.nimbletools/user.json

​
Use Cases

​
Diagnosing Authentication Issues

When experiencing login or token problems: 
# Check detailed auth status
ntcli ws debug

# Look for expired tokens or missing files
ntcli ws debug --verbose

# Refresh expired tokens
ntcli token refresh workspace-name

​
Troubleshooting Workspace Access

When workspaces aren’t appearing or switching fails: 
# Check workspace file integrity
ntcli workspace debug

# Compare with server state
ntcli workspace sync

# Fix any identified issues
ntcli auth login  # if authentication expired

​
Storage Health Check

For general system health verification: 
# Quick health check
ntcli ws debug

# Full detailed inspection
ntcli ws debug --verbose

​
Output Indicators

The command uses visual indicators for quick status assessment:
  • ✓ - Healthy/Valid status
  • ✗ - Problem/Invalid status
  • ⚠️ - Warning/Attention needed
  • 📁 - File/Directory information
  • 🔑 - Authentication-related
  • 👤 - User profile information

workspace sync

Compare local and server workspaces

auth status

Check authentication status

token refresh

Refresh workspace access tokens

workspace list

List all available workspaces