Package Exports

@hololabdev/hhl-cli
@hololabdev/hhl-cli/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@hololabdev/hhl-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@hololabdev/hhl-cli

CLI for orchestrating local development across a multi-app workspace.

Install

npm install -g @hololabdev/hhl-cli

From a git checkout:

pnpm install
pnpm build
node bin/hhl.js install   # optional: register `hhl` in your shell

Quick start

hhl setup
hhl doctor
hhl dev

Commands

Command	Description
`hhl install`	Register the `hhl` shell command (bash alias + Windows `.cmd`)
`hhl setup`	Install dependencies, copy env templates, optional MongoDB
`hhl dev`	Start services (`--profile`, `--only`, `--no-wait`)
`hhl stop [service]`	Stop all services or one by id
`hhl restart <service>`	Restart one service
`hhl status`	Show PID table (`--watch` to refresh)
`hhl doctor`	Workspace health checks (`--fix` to auto-repair)
`hhl logs [service]`	Tail workspace logs (`--follow`, `--all`)
`hhl open [service]`	Open service URL in the browser (`--all`)
`hhl ssl [service]`	Generate self-signed SSL certs (`--all`)
`hhl env check [service]`	List missing env keys (values not shown)
`hhl env init <service>`	Interactive `.env` setup
`hhl kill-port <port>`	Free a port blocked by another process
`hhl config`	Print current configuration
`hhl config set workspace <path>`	Set workspace root
`hhl version`	Show version, Node.js, install source
`hhl upgrade`	Update the CLI
`hhl -v`	Print version (shortcut)

Profiles

Profiles are defined in hhl.config.json. The default example includes:

Profile	Typical use
`full`	All apps in the workspace
`device`	Apps needed for on-device testing
`backend`	API / server apps only

Examples:

hhl dev
hhl dev --profile backend
hhl dev --only app-a,app-b

Service ids and app paths come from your config — see hhl.config.example.json.

Configuration

Copy hhl.config.example.json → hhl.config.json.
Set workspaceRoot to the directory that contains your app folders.
Adjust apps, ports, and profiles to match your layout.

Runtime state and logs are stored under .hhl/ inside the workspace root (not next to the CLI install).

Upgrade

hhl upgrade

Or reinstall from npm:

npm install -g @hololabdev/hhl-cli@latest