Command Reference

Complete reference for all hu CLI commands.

Authentication

Open your browser to authenticate with Health Universe.

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

Option

Description

--api-url

Override the API endpoint for this login

--auth-url

Override the URL of the browser sign-in page (the NextJS host)

`hu logout`

Clear the stored authentication token.

hu logout

`hu whoami`

Display the currently authenticated user and active workspace.

hu whoami
hu whoami --json

Apps

Manage applications in the current workspace.

`hu apps list`

List all applications in the active workspace.

hu apps list
hu apps list --json

`hu apps create`

Create a new application.

hu apps create --name "My App" --repo owner/repo --sdk FA --main-file main.py

Option

Description

--name

Application name

--repo

GitHub repository in owner/repo format

--sdk

App runtime: FA (FastAPI), A2A (Agent), SL (Streamlit)

--category

Research area category

--description

App description

--main-file

Entry point file (e.g. main.py)

--private

Make the app private

--json

Output as JSON

`hu apps delete`

Delete an application.

hu apps delete <app-id>

`hu apps open`

Open an application in your browser.

hu apps open <app-id>

`hu apps status`

Check the deployment status of an application.

hu apps status <app-id>
hu apps status <app-id> --json

`hu apps deploy`

Trigger a deployment for an application.

hu apps deploy <app-id>
hu apps deploy <app-id> --wait     # Poll until deployment completes
hu apps deploy <app-id> --json

Option

Description

--wait

Poll every 5 seconds until the deployment finishes (up to 10 minutes)

--json

Output as JSON

With --wait, the CLI polls the deployment status every 5 seconds for up to 10 minutes. If the deployment hasn't completed by then, the command exits — the deployment itself continues on the server. Check progress with hu apps status <app-id>.

`hu apps logs`

View logs for an application deployment.

hu apps logs <app-id>              # Deployment/runtime logs
hu apps logs <app-id> --build      # Build logs
hu apps logs <app-id> --json

Option

Description

--build

Show build logs instead of runtime logs

--json

Output as JSON

`hu apps health`

Trigger a health check for an application.

hu apps health <app-id>
hu apps health <app-id> --json

`hu apps archive`

Archive an application. This shuts down the running instance to save resources while keeping all configuration, metadata, and deployment history intact. The app will no longer be accessible to users until it is unarchived.

hu apps archive <app-id>

`hu apps unarchive`

Restore an archived application and bring it back online.

hu apps unarchive <app-id>

App Collaborators

`hu apps collaborators list`

List collaborators for an application.

hu apps collaborators list <app-id>
hu apps collaborators list <app-id> --json

`hu apps collaborators add`

Add collaborators to an application by email. Pass multiple emails as a comma-separated string.

hu apps collaborators add <app-id> "[email protected],[email protected]"

If some emails don't match existing Health Universe accounts, those will be skipped and the CLI will tell you which ones weren't found. The remaining valid emails are still added.

`hu apps collaborators remove`

Remove a collaborator from an application.

hu apps collaborators remove <app-id> <collaborator-id>

App Domains

Setting up a custom domain is a multi-step process:

Add the domain to your app
Configure DNS — add the CNAME or A record shown in the output to your DNS provider
Verify — confirm that DNS is configured correctly
Activate — switch live traffic to the custom domain

`hu apps domains list`

List custom domains for an application.

hu apps domains list <app-id>
hu apps domains list <app-id> --json

`hu apps domains add`

Add a custom domain to an application. The output will include DNS records you need to configure with your domain provider before verification.

hu apps domains add <app-id> app.example.com

`hu apps domains verify`

Verify that DNS records are configured correctly for the domain. Run this after you've added the required DNS records at your domain provider.

hu apps domains verify <app-id> <domain-id>
hu apps domains verify <app-id> <domain-id> --json

`hu apps domains activate`

Activate a verified custom domain so it starts serving traffic.

hu apps domains activate <app-id> <domain-id>

`hu apps domains remove`

Remove a custom domain from an application.

hu apps domains remove <app-id> <domain-id>

Orgs

The orgs command group manages your active workspace (organization). Workspaces are identified by their slug — a short, human-readable identifier shown everywhere in CLI output (banner, whoami, orgs list, config show).

`hu orgs list`

List all workspaces you have access to.

hu orgs list
hu orgs list --json

`hu orgs switch`

Switch the active workspace. All subsequent commands will operate in the selected workspace.

hu orgs switch <slug>          # Preferred — switch by slug
hu orgs switch <workspace-id>  # ID fallback
hu orgs switch personal        # Switch to your personal workspace

`hu orgs members`

List members of the active workspace.

hu orgs members
hu orgs members --json

Projects

`hu projects list`

List projects in the active workspace.

hu projects list
hu projects list --json

`hu projects create`

Create a new project in the active workspace.

hu projects create "My Project"
hu projects create "My Project" --json

`hu projects delete`

Delete a project.

hu projects delete <project-id>

`hu projects collaborators list`

List collaborators on a project.

hu projects collaborators list <project-id>

`hu projects collaborators add`

Add a collaborator to a project.

hu projects collaborators add <project-id> <user-id> --role admin

Option

Description

--role

Role to assign: admin or member

`hu projects collaborators remove`

Remove a collaborator from a project.

hu projects collaborators remove <project-id> <user-id>

Threads

`hu threads list`

List threads in the active workspace.

hu threads list
hu threads list --search "diabetes"
hu threads list --project <project-id> --limit 10
hu threads list --json

Option

Description

--search

Filter threads by search term

--project

Filter by project ID

--limit

Maximum number of results

--json

Output as JSON

`hu threads delete`

Delete a thread.

hu threads delete <thread-id>

Config

`hu config show`

Display the current CLI configuration, including token status.

hu config show
hu config show --json

`hu config set`

Update a configuration value.

hu config set apiUrl https://apps.healthuniverse.com
hu config set authUrl https://www.healthuniverse.com

Key

Description

Default

apiUrl

NestJS API base URL

https://apps.healthuniverse.com

authUrl

URL of the browser sign-in page (the NextJS host)

https://www.healthuniverse.com

`hu config unset`

Clear a single configuration key.

hu config unset apiUrl
hu config unset orgId    # Also clears orgSlug — they're paired

`hu config reset`

Wipe the entire configuration (and credentials by default). Useful for starting clean without removing ~/.hu/ manually.

hu config reset                 # Clears config + token
hu config reset --keep-token    # Clears config but preserves the auth token

Option

Description

--keep-token

Preserve the stored auth token; only reset URLs and workspace selection

Admin

These commands are only available to platform administrators.

`hu admin stats`

Show platform-wide statistics (threads, users) across 24h, 7d, 30d, and all-time.

hu admin stats
hu admin stats --json

`hu admin users`

List recently active users.

hu admin users
hu admin users --limit 20 --json

`hu admin orgs`

List all workspaces on the platform.

hu admin orgs
hu admin orgs --json

Common Workflows

Deploy an app and monitor it

hu apps deploy <app-id> --wait
hu apps logs <app-id>
hu apps status <app-id>

Set up a new app from scratch

hu login
hu orgs switch my-org
hu apps create --name "Patient Risk Model" --repo myorg/risk-model --sdk FA --main-file main.py
hu apps deploy <app-id> --wait
hu apps open <app-id>

Add collaborators to an app

hu apps collaborators add <app-id> "[email protected],[email protected]"
hu apps collaborators list <app-id>

Set up a custom domain

hu apps domains add <app-id> risk-model.example.com
# Configure DNS records as instructed, then:
hu apps domains verify <app-id> <domain-id>
hu apps domains activate <app-id> <domain-id>

Switch between environments

# Use local dev environment
hu config set apiUrl http://localhost:3002
hu config set authUrl http://localhost:3000
hu login

# Switch back to production
hu config set apiUrl https://apps.healthuniverse.com
hu config set authUrl https://www.healthuniverse.com
hu login

PreviousOverview NextTroubleshooting

Last updated 11 days ago

Was this helpful?

hashtagAuthentication

hashtaghu login

hashtaghu logout

hashtaghu whoami

hashtagApps

hashtaghu apps list

hashtaghu apps create

hashtaghu apps delete

hashtaghu apps open

hashtaghu apps status

hashtaghu apps deploy

hashtaghu apps logs

hashtaghu apps health

hashtaghu apps archive

hashtaghu apps unarchive

hashtagApp Collaborators

hashtaghu apps collaborators list

hashtaghu apps collaborators add

hashtaghu apps collaborators remove

hashtagApp Domains

hashtaghu apps domains list

hashtaghu apps domains add

hashtaghu apps domains verify

hashtaghu apps domains activate

hashtaghu apps domains remove

hashtagOrgs

hashtaghu orgs list

hashtaghu orgs switch

hashtaghu orgs members

hashtagProjects

hashtaghu projects list

hashtaghu projects create

hashtaghu projects delete

hashtaghu projects collaborators list

hashtaghu projects collaborators add

hashtaghu projects collaborators remove

hashtagThreads

hashtaghu threads list

hashtaghu threads delete

hashtagConfig

hashtaghu config show

hashtaghu config set

hashtaghu config unset

hashtaghu config reset

hashtagAdmin

hashtaghu admin stats

hashtaghu admin users

hashtaghu admin orgs

hashtagCommon Workflows

hashtagDeploy an app and monitor it

hashtagSet up a new app from scratch

hashtagAdd collaborators to an app

hashtagSet up a custom domain

hashtagSwitch between environments

Authentication

`hu login`

`hu logout`

`hu whoami`

Apps

`hu apps list`

`hu apps create`

`hu apps delete`

`hu apps open`

`hu apps status`

`hu apps deploy`

`hu apps logs`

`hu apps health`

`hu apps archive`

`hu apps unarchive`

App Collaborators

`hu apps collaborators list`

`hu apps collaborators add`

`hu apps collaborators remove`

App Domains

`hu apps domains list`

`hu apps domains add`

`hu apps domains verify`

`hu apps domains activate`

`hu apps domains remove`

Orgs

`hu orgs list`

`hu orgs switch`

`hu orgs members`

Projects

`hu projects list`

`hu projects create`

`hu projects delete`

`hu projects collaborators list`

`hu projects collaborators add`

`hu projects collaborators remove`

Threads

`hu threads list`

`hu threads delete`

Config

`hu config show`

`hu config set`

`hu config unset`

`hu config reset`

Admin

`hu admin stats`

`hu admin users`

`hu admin orgs`

Common Workflows

Deploy an app and monitor it

Set up a new app from scratch

Add collaborators to an app

Set up a custom domain

Switch between environments