Auth Commands
Manage Bootspring authentication and API keys.
Synopsis
Loading code block...
Commands
| Command | Description |
|---|---|
login | Authenticate with Bootspring |
logout | Log out and clear credentials |
status | Check authentication status |
token | Display or refresh API token |
bootspring auth login
Authenticate with your Bootspring account.
Usage
Loading code block...
Options
| Option | Description |
|---|---|
--key <key> | Provide API key directly |
--browser | Open browser for OAuth login |
Examples
Loading code block...
Output:
Bootspring Authentication
═══════════════════════════════════════════════════════════════════
? Enter your API key: bsk_************************
Verifying...
✓ Authenticated successfully
Account: john@example.com
Tier: Pro
Expires: Never
API key saved to: ~/.bootspring/credentials
Loading code block...
Browser login flow:
Opening browser for authentication...
Visit this URL if browser doesn't open:
https://bootspring.com/auth/cli?token=abc123
Waiting for authentication...
✓ Authenticated successfully
bootspring auth logout
Log out and remove stored credentials.
Usage
Loading code block...
Options
| Option | Description |
|---|---|
--all | Log out from all devices |
Example
Loading code block...
Output:
Logged out successfully
Credentials removed from: ~/.bootspring/credentials
bootspring auth status
Check current authentication status.
Usage
Loading code block...
Options
| Option | Description |
|---|---|
--json | Output as JSON |
Example
Loading code block...
Output (authenticated):
Authentication Status
═══════════════════════════════════════════════════════════════════
Status: Authenticated ✓
Account: john@example.com
Tier: Pro
Devices: 3/5 used
API Usage This Month
────────────────────
Calls: 4,521 / 10,000 (45%)
Reset: April 1, 2024
Output (not authenticated):
Authentication Status
═══════════════════════════════════════════════════════════════════
Status: Not authenticated
Log in with: bootspring auth login
Get API key at: https://bootspring.com/dashboard/api-keys
bootspring auth token
Display or refresh the API token.
Usage
Loading code block...
Options
| Option | Description |
|---|---|
--show | Display the current token |
--refresh | Refresh the token |
--copy | Copy token to clipboard |
Examples
Loading code block...
Output:
API Token
═══════════════════════════════════════════════════════════════════
Token: bsk_************************4f3a
Type: Pro
Valid: Yes
Use --show to display full token
Loading code block...
Output:
API Token
═══════════════════════════════════════════════════════════════════
Token: bsk_live_1234567890abcdef1234567890abcdef4f3a
⚠️ Keep this token secret! Don't share or commit to version control.
Loading code block...
API Key Management
Getting an API Key
- Visit https://bootspring.com/dashboard
- Go to Settings > API Keys
- Click "Create New Key"
- Copy and save your key securely
Key Types
| Type | Usage | Permissions |
|---|---|---|
| Development | Local development | Full access |
| CI/CD | Automated pipelines | Quality checks only |
| Read-only | Documentation access | Read context only |
Storing Keys
Keys are stored in ~/.bootspring/credentials:
Loading code block...
Or use environment variable:
Loading code block...
Security Best Practices
DO
- Store keys in environment variables
- Use CI/CD-specific keys for pipelines
- Rotate keys periodically
- Use read-only keys when possible
DON'T
- Commit keys to version control
- Share keys with others
- Use production keys in development
- Store keys in plain text files in project
Revoking Keys
If a key is compromised:
- Go to https://bootspring.com/dashboard/api-keys
- Find the compromised key
- Click "Revoke"
- Generate a new key
Troubleshooting
Invalid API Key
Error: Invalid API key
Solutions:
- Verify key is correct
- Check key hasn't been revoked
- Ensure key has required permissions
Expired Session
Error: Session expired
Solutions:
- Run
bootspring auth loginagain - Check account status at dashboard
Rate Limited
Error: Rate limit exceeded
Solutions:
- Wait for rate limit reset
- Check usage at dashboard
- Consider upgrading tier
Related
- Tiers and Limits - Tier information
- Dashboard Guide - Managing account
- Security - Security best practices