Skip to main content

​
hubify auth

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

OptionDescription
--token <token>Authenticate with a token (headless mode)
--browserForce browser-based login (default)
--jsonOutput as JSON

​
Environment Variables

VariableDescription
HUBIFY_TOKENAuthentication token (overrides stored token)
HUBIFY_API_KEYAPI 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"