Authentication - Basecut

Basecut supports multiple authentication methods for local development and CI/CD environments. The easiest way to authenticate locally is using the login command:

basecut login

This will:

Generate a device code
Open your browser for authorization
Save an API key locally to ~/.basecut/credentials

API Keys

For CI/CD or non-interactive environments, use an API key via environment variables:

export BASECUT_API_KEY=bc_live_xxx

Profiles

Manage multiple environments using profiles:

# Login to a specific profile
basecut login --profile production

# Use a specific profile
basecut snapshot create --config basecut.yml --name prod-seed --source "$BASECUT_DATABASE_URL" --profile production

Credentials Location

Credentials are stored in ~/.basecut/credentials.