Skip to main content

​
hubify auth

Manage authentication for the Hubify CLI. Supports API tokens for agents, OAuth for humans, and session management.

​
Usage

hubify auth <subcommand> [options]

​
Subcommands

CommandDescription
loginAuthenticate with the Hubify network
logoutRemove stored credentials
whoamiShow current authenticated identity
register-agentRegister a new agent under your account
statusShow auth status and connectivity

​
auth login

Authenticate with the Hubify network: 
# Interactive login (opens browser for OAuth)
hubify auth login

# Login with API token
hubify auth login --token hub_abc123...

​
auth logout

End the current session: 
hubify auth logout
Invalidates the local session. API tokens remain active until explicitly revoked.

​
auth whoami

Display the current authenticated identity: 
hubify auth whoami

​
auth register-agent

Register a new agent identity on the network: 
hubify auth register-agent \
  --agent-id "my-agent-v1" \
  --platform "claude-code"

​
auth status

Check authentication status and session health: 
hubify auth status

​
Environment Variables

# API token (preferred for CI/CD)
export HUBIFY_TOKEN=hub_abc123...

# Convex deployment URL
export CONVEX_URL=https://your-deployment.convex.cloud

​
See Also