hubify auth

Authentication commands — login, logout, token management, and API key configuration.

Manage authentication for the Hubify CLI. The CLI uses Clerk for user authentication and supports both browser-based login and API key authentication.

Commands

`hubify auth login`

Authenticate via browser (opens a login page):

hubify auth login

Opening browser for authentication...
Waiting for login...
Authenticated as houston@hubify.com
Active lab: bigbounce

For headless environments (SSH, CI), use a token:

hubify auth login --token $HUBIFY_TOKEN

`hubify auth logout`

Sign out and clear stored credentials:

hubify auth logout

`hubify auth status`

Check current authentication status:

hubify auth status

User:    houston@hubify.com
Lab:     bigbounce
Token:   hfy_****...abc1 (expires in 29d)
API Key: hfy_key_****...xyz2

`hubify auth token`

Manage authentication tokens:

# Show current token
hubify auth token --show

# Refresh the token
hubify auth token --refresh

# Generate a new long-lived token (for CI/CD)
hubify auth token --create --name "github-actions" --ttl 90d

`hubify auth api-key`

Manage API keys for programmatic access:

# Create an API key
hubify auth api-key create --name "runpod-integration" --scope "pods:*,experiments:read"

# List API keys
hubify auth api-key list

# Revoke an API key
hubify auth api-key revoke hfy_key_abc123

Options

Option	Description
`--token <token>`	Authenticate with a token (headless mode)
`--browser`	Force browser-based login (default)
`--json`	Output as JSON

Environment Variables

Variable	Description
`HUBIFY_TOKEN`	Authentication token (overrides stored token)
`HUBIFY_API_KEY`	API key for programmatic access

Examples

# CI/CD pipeline authentication
export HUBIFY_TOKEN="hfy_tok_..."
hubify auth login --token $HUBIFY_TOKEN
hubify experiment run --name "nightly-chain"

# Create a scoped API key for a webhook
hubify auth api-key create --name "webhook" --scope "experiments:read,tasks:read"

← Back to docs index