Overview
Clear all stored authentication credentials from your system. This includes your NimbleTools JWT token and any cached workspace tokens.Syntax
Examples
Basic Logout
- Remove all stored authentication tokens
- Clear workspace token cache
- Confirm successful logout
What Gets Cleared
When you runntcli auth logout
, the following credentials are removed:
NimbleTools JWT
Your main authentication token used for platform access
Workspace Tokens
All cached workspace-specific access tokens
OAuth Tokens
Clerk OAuth refresh tokens and session data
User Profile
Cached user profile information
Credential Storage Locations
Credentials are removed from secure system storage:- macOS
- Linux
- Windows
macOS Keychain
- Location:
~/Library/Keychains/login.keychain
- Service:
ntcli-auth
- Items: JWT tokens, OAuth tokens, user data
Security Benefits
Regular logout provides several security benefits:- Token Invalidation: Prevents use of cached tokens if device is compromised
- Session Management: Clears browser-based OAuth sessions
- Multi-Device Security: Prevents token reuse across different machines
- Compliance: Meets security requirements for shared or managed systems
Logout only clears local credentials. Your account and workspaces remain active on the NimbleTools platform.
When to Use Logout
Switching Accounts
Switching Accounts
When you need to authenticate with a different NimbleTools account:
Security Best Practices
Security Best Practices
On shared or public computers:
Troubleshooting Authentication
Troubleshooting Authentication
When experiencing authentication issues:
Token Refresh Issues
Token Refresh Issues
When workspace tokens are corrupted or expired:
Verification
After logout, verify that credentials were cleared:Re-authentication
To authenticate again after logout:1
Login
2
Verify Status
3
Refresh Workspace Tokens
Logout vs Token Management
Understanding the difference between logout and token operations:Command | Effect | Use Case |
---|---|---|
ntcli auth logout | Clears all credentials | Complete logout, account switching |
ntcli token refresh | Refreshes workspace tokens only | Token expired, need new permissions |
ntcli auth status | Shows current status | Check authentication state |
Error Handling
Already logged out
Already logged out
Message: “No credentials found to clear”Action: This is normal - you’re already logged out
Related Commands
auth login
Authenticate with NimbleTools platform
auth status
Check current authentication status
token refresh
Refresh workspace access tokens
workspace clear
Clear active workspace selection
Next Steps
After logout, you’ll need to re-authenticate to use ntcli:- Login:
ntcli auth login
- Select workspace:
ntcli workspace select
orntcli workspace create
- Refresh tokens: `ntcli token refresh
- Resume work: Continue with your MCP server management