Auth Commands | Bootspring Docs

Manage Bootspring authentication and API keys.

Synopsis#

bootspring auth <command> [options]

Commands#

Command	Description
`login`	Authenticate with Bootspring
`logout`	Log out and clear credentials
`status`	Check authentication status
`token`	Display or refresh API token

Authenticate with your Bootspring account.

Usage#

bootspring auth login [options]

Options#

Option	Description
`--key <key>`	Provide API key directly
`--browser`	Open browser for OAuth login

Examples#

# Interactive login
bootspring auth login

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

# Login with key directly
bootspring auth login --key bsk_your_api_key

# Browser-based login
bootspring auth login --browser

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#

bootspring auth logout [options]

Options#

Option	Description
`--all`	Log out from all devices

Example#

bootspring auth logout

Output:

Logged out successfully
Credentials removed from: ~/.bootspring/credentials

bootspring auth status#

Check current authentication status.

Usage#

bootspring auth status [options]

Options#

Option	Description
`--json`	Output as JSON

Example#

bootspring auth status

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#

bootspring auth token [options]

Options#

Option	Description
`--show`	Display the current token
`--refresh`	Refresh the token
`--copy`	Copy token to clipboard

Examples#

# Show current token (masked)
bootspring auth token

Output:

API Token
═══════════════════════════════════════════════════════════════════

Token: bsk_************************4f3a
Type:  Pro
Valid: Yes

Use --show to display full token

# Show full token
bootspring auth token --show

Output:

API Token
═══════════════════════════════════════════════════════════════════

Token: bsk_live_1234567890abcdef1234567890abcdef4f3a

⚠️  Keep this token secret! Don't share or commit to version control.

# Refresh token
bootspring auth token --refresh

# Copy to clipboard
bootspring auth token --copy

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:

{
  "apiKey": "bsk_live_...",
  "email": "john@example.com",
  "tier": "pro"
}

Or use environment variable:

export BOOTSPRING_API_KEY=bsk_your_key

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 login again
Check account status at dashboard

Rate Limited#

Error: Rate limit exceeded

Solutions:

Wait for rate limit reset
Check usage at dashboard
Consider upgrading tier

Tiers and Limits - Tier information
Dashboard Guide - Managing account
Security - Security best practices