Authentication

hopx auth <subcommand> [options]

hopx auth login [OPTIONS]

# OAuth login with Google (default)
hopx auth login

# OAuth login with GitHub
hopx auth login --provider GitHubOAuth

# Headless mode (for servers/containers without browsers)
hopx auth login --no-browser

✓ Authentication successful
✓ You can now create API keys with 'hopx auth keys create'

hopx auth logout [OPTIONS]

# Log out
hopx auth logout

✓ Logged out successfully

hopx auth status [OPTIONS]

# Check authentication status
hopx auth status

✓ Authenticated
✓ API key: hopx_live_... (configured)

hopx auth validate [OPTIONS]

# Validate API key
hopx auth validate

✓ API key is valid

hopx auth refresh [OPTIONS]

# Refresh OAuth token
hopx auth refresh

✓ Token refreshed successfully

hopx auth keys list [OPTIONS]

# List API keys
hopx auth keys list

┌──────────────┬─────────────────────┬──────────────┐
│ Name         │ Created             │ Last Used    │
├──────────────┼─────────────────────┼──────────────┤
│ my-key       │ 2025-01-27 10:00:00 │ 2025-01-27   │
│ production   │ 2025-01-26 09:00:00 │ 2025-01-27   │
└──────────────┴─────────────────────┴──────────────┘

hopx auth keys create [OPTIONS]

# Create API key with name
hopx auth keys create --name "my-key"

# Create with auto-generated name
hopx auth keys create

✓ API key created: hopx_live_...
✓ Key stored securely

hopx auth keys revoke KEY_ID [OPTIONS]

# Revoke API key
hopx auth keys revoke key_abc123

✓ API key revoked: key_abc123

hopx auth keys info KEY_ID [OPTIONS]

# Get API key info
hopx auth keys info key_abc123

┌─────────────┬─────────────────────────────────────┐
│ Property    │ Value                               │
├─────────────┼─────────────────────────────────────┤
│ Name        │ my-key                               │
│ Created     │ 2025-01-27 10:00:00                 │
│ Last Used   │ 2025-01-27 12:00:00                 │
└─────────────┴─────────────────────────────────────┘

# Login with browser
hopx auth login

# Create API key
hopx auth keys create --name "my-key"

# Set API key
export HOPX_API_KEY="hopx_live_..."

# Verify
hopx auth status

#!/bin/bash

# Check authentication
if ! hopx auth status > /dev/null 2>&1; then
    echo "Not authenticated. Please run 'hopx auth login'"
    exit 1
fi

# Proceed with commands
hopx sandbox create --template python

#!/bin/bash

# Create API key
KEY_NAME="ci-$(date +%s)"
hopx auth keys create --name "$KEY_NAME"

# Use in script
export HOPX_API_KEY=$(hopx auth keys info "$KEY_NAME" --output json | jq -r '.key')