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

Getting started

Command	Description
`hhl setup`	Install dependencies, copy env templates, optional MongoDB
`hhl doctor`	Workspace health checks (`--fix` to auto-repair)
`hhl install`	Register the `hhl` shell command

Development

Command	Description
`hhl dev`	Start services (`--profile`, `--only`, `--filter`, `--no-wait`)
`hhl run <service> <script>`	Run an npm script in a service (`-- <args>`)
`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 logs [service]`	Tail workspace logs (`--follow`, `--all`)
`hhl open [service]`	Open service URL in the browser (`--all`)

Environment

Command	Description
`hhl env check [service]`	List missing env keys (values not shown)
`hhl env diff [service]`	Compare `.env` keys with example file
`hhl env init <service>`	Interactive `.env` setup
`hhl ssl [service]`	Generate self-signed SSL certs (`--all`)
`hhl config`	Print current configuration
`hhl config set workspace <path>`	Set workspace root
`hhl kill-port <port>`	Free a port blocked by another process

CLI

Command	Description
`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
hhl dev --filter app-a
hhl run app-a db:migrate
hhl run app-a test -- --watch

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). Log files include ISO timestamps on each line.

When installed from npm, hhl shows a one-line hint if a newer version is available. Set HHL_NO_UPDATE_NOTIFIER=1 to disable.

Upgrade

hhl upgrade

Or reinstall from npm:

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