Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Command Reference

Complete reference for all hu CLI commands.

Authentication

hu login

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 create

Create a new application.

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 open

Open an application in your browser.

hu apps status

Check the deployment status of an application.

hu apps deploy

Trigger a deployment for an application.

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.

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 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 unarchive

Restore an archived application and bring it back online.

App Collaborators

hu apps collaborators list

List collaborators for an application.

hu apps collaborators add

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

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.

App Domains

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

  1. Add the domain to your app

  2. Configure DNS — add the CNAME or A record shown in the output to your DNS provider

  3. Verify — confirm that DNS is configured correctly

  4. Activate — switch live traffic to the custom domain

hu apps domains list

List custom domains for an application.

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 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 activate

Activate a verified custom domain so it starts serving traffic.

hu apps domains remove

Remove a custom domain from an application.

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 switch

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

hu orgs members

List members of the active workspace.

Projects

hu projects list

List projects in the active workspace.

hu projects create

Create a new project in the active workspace.

hu projects delete

Delete a project.

hu projects collaborators list

List collaborators on a project.

hu projects collaborators add

Add a collaborator to a project.

Option
Description

--role

Role to assign: admin or member

hu projects collaborators remove

Remove a collaborator from a project.

Threads

hu threads list

List threads in the active workspace.

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.

Config

hu config show

Display the current CLI configuration, including token status.

hu config set

Update a configuration value.

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 reset

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

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 users

List recently active users.

hu admin orgs

List all workspaces on the platform.

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

PreviousOverviewNextTroubleshooting

Last updated

Was this helpful?