Overview

The Health Universe CLI (hu) lets you manage applications, deployments, workspaces, and projects directly from your terminal. Everything you can do in the web dashboard — deploying apps, managing collaborators, switching workspaces — you can do from the command line.

Prerequisites

• Node.js 18 or later

• npm 9 or later (included with Node.js)

• A Health Universe account

Installation

npm install -g @health-universe/cli

After installation, the hu command is available globally.

To upgrade to the latest version:

npm install -g @health-universe/cli@latest

To uninstall:

npm uninstall -g @health-universe/cli

Uninstalling removes the CLI but leaves your config and credentials in ~/.hu/. To remove those as well, delete the directory: rm -rf ~/.hu

Quick Start

# 1. Log in (opens your browser)
hu login

# 2. Check your identity and active workspace
hu whoami

# 3. List your apps
hu apps list

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

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

The CLI authenticates through your browser — hu login opens a sign-in page and no passwords are entered in the terminal. Tokens are valid for 24 hours and refresh automatically. Credentials are stored in ~/.hu/credentials.

All read commands support --json for machine-readable output:

hu apps list --json | jq '.[].name'

Usage Modes

The CLI works in two modes:

• Single-command mode — run any command directly from your shell. Great for scripts and automation.

  hu apps list --json | jq '.[].name'

• Interactive REPL mode — run hu with no arguments to enter an interactive session. The REPL displays your authentication status and active workspace, and supports tab completion for all commands.

  $ hu
  
    ╦ ╦╔═╗╔═╗╦ ╔╦╗╦ ╦  ╦ ╦╔╗╔╦╦  ╦╔═╗╦═╗╔═╗╔═╗
    ╠═╣║╣ ╠═╣║  ║ ╠═╣  ║ ║║║║║╚╗╔╝║╣ ╠╦╝╚═╗║╣
    ╩ ╩╚═╝╩ ╩╩═╝╩ ╩ ╩  ╚═╝╝╚╝╩ ╚╝ ╚═╝╩╚═╚═╝╚═╝
  
    Version:    0.2.0
    Status:     AUTHENTICATED
    Workspace:  my-org
  
  hu> apps list
  hu> apps deploy abc123 --wait

  REPL-only commands:

  Command	Description
  help	Show all available commands
  clear	Clear the screen
  exit / quit	Exit the REPL

What's Next

• Command Reference — full list of all available commands

• Troubleshooting — common errors and how to fix them