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
Show full file contents for detailed debugging
Examples
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
Command Group Alias
Storage Locations
The command inspects these configuration files:
| File | Purpose | Location |
|---|
workspaces.json | Workspace definitions and metadata | ~/.nimbletools/workspaces.json |
tokens.json | Authentication tokens | ~/.nimbletools/tokens.json |
user.json | User 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
