Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hubify.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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"