@health-universe/cli

Command-line interface for the Health Universe platform. Manage applications, deployments, organizations, and projects from your terminal.

Install

npm install -g @health-universe/cli

Quick Start

# Authenticate (opens browser)
hu login

# Check who you're logged in as
hu whoami

# List your applications
hu apps list

# Deploy an app and wait for it to finish
hu apps deploy <app-id> --wait

Authentication

The CLI authenticates via your browser using your existing Health Universe account. Tokens are valid for 24 hours.

# Log in (opens browser for Clerk auth)
hu login

# Log out (clears stored token)
hu logout

Credentials are stored in ~/.hu/credentials with 0600 permissions.

Commands

hu whoami

Show the authenticated user and active organization.

hu whoami
# User:  Jane Smith ([email protected])
# Org:   my-org

hu whoami --json

hu apps

Manage applications in the current organization.

# List all apps
hu apps list
hu apps list --json

# Check deployment status
hu apps status <app-id>

# Deploy an application
hu apps deploy <app-id>
hu apps deploy <app-id> --wait    # Poll until complete

# View logs
hu apps logs <app-id>             # Deployment logs
hu apps logs <app-id> --build     # Build logs

hu orgs

Manage organization context.

# List organizations
hu orgs list

# Switch active organization (by slug, falls back to ID)
hu orgs switch <slug>
hu orgs switch personal

hu projects

Manage projects within the active organization.

hu projects list
hu projects list --json

hu config

View and manage CLI configuration.

# Show current config
hu config show

# Set API URL
hu config set apiUrl https://apps.healthuniverse.com

# Set auth URL (for the browser login flow)
hu config set authUrl https://www.healthuniverse.com

Configuration is stored in ~/.hu/config.json.

Environments

The same CLI works for both production and local development:

# Production (default)
hu login

# Local development
hu login --api-url http://localhost:3002 --auth-url http://localhost:3000

Or set the environment permanently:

hu config set apiUrl http://localhost:3002
hu config set authUrl http://localhost:3000
hu login

JSON Output

All read commands support --json for machine-readable output, useful for scripting:

hu apps list --json | jq '.[].name'
hu apps status <id> --json
hu whoami --json
hu config show --json

Development

# From the monorepo root
cd packages/cli

# Build
yarn build

# Watch mode
yarn dev

# Type check
yarn check:type

# Run locally without installing globally
node dist/index.js --help