CLI Reference

[CLI REFERENCE]

30 groups · 130+ subcommands. Every command runs as hoox or its short alias hx. After the first monorepo run, the CLI remembers the path so hx works from any directory. Bare hoox auto-runs onboard when wrangler.jsonc is missing; otherwise it launches the TUI.

@hoox-sh/hoox-cli • v0.13.067 test files · TUI 0.3.x

Installation guide
Quick Start
Global options (apply to every command)
--jsonMachine-parseable JSON output
--quietMinimal output
--no-colorDisable ANSI colors
-y, --yesSkip confirmation prompts
-V, --versionPrint version
-h, --helpShow help
[]
01

Onboard

4 groups
[ Onboard ]01

hoox onboard

alias: bootstrap · quickstart

One-shot bootstrap: runs init + setup in sequence. Recommended first command. Aliases: bootstrap, quickstart.

Flags — check to add to commands
[ Onboard ]02

hoox init

Interactive wizard: write wrangler.jsonc and collect account/secrets. Does not generate keys, apply schema, or deploy.

After init, run hoox setup (or prefer hoox onboard).

Flags — check to add to commands
[ Onboard ]03

hoox setup

Provision workspace: wrangler, submodules, build, keys, D1 schema, secrets, dashboard. Each step skippable.

Flags — check to add to commands
[ Onboard ]04

hoox clone

Clone worker repositories as git submodules. No name lists clone status; --all clones every worker.

Flags — check to add to commands
02

Develop

4 groups
[ Develop ]01

hoox dev

Local development engine. Start all enabled workers, a single worker, or the Next.js dashboard (native or Docker).

Flags — check to add to commands
[ Develop ]02

hoox dashboard

Dashboard shortcuts. Delegates to dev dashboard / deploy dashboard.

Flags — check to add to commands
[ Develop ]03

hoox tui

OpenTUI terminal operations center. Bare hoox auto-runs onboard when wrangler.jsonc is missing; otherwise launches the TUI (or menu).

Remote mode is fail-closed: Bearer (HOOX_API_TOKEN / --token), Cloudflare® Access service tokens, or explicit --allow-insecure.

Flags — check to add to commands
[ Develop ]04

hoox workers

Per-worker convenience facade: list status, start dev, or tail logs (delegates to dev/logs).

03

Ship

3 groups
[ Ship ]01

hoox deploy

Edge deployment: workers, dashboard (OpenNext), Telegram webhook, KV config, version history and rollback.

Flags — check to add to commands
[ Ship ]02

hoox infra

Cloudflare® resource lifecycle: D1, KV, R2, Queues, Vectorize, Analytics Engine — plus auto-provision from wrangler.jsonc.

Flags — check to add to commands
[ Ship ]03

hoox update

Pull latest main repo, update a worker submodule, or upgrade wrangler. Not an npm self-update of the CLI binary.

04

Configure

4 groups
[ Configure ]01

hoox config

wrangler.jsonc and nested env/kv tools. Prefer top-level hoox secrets / hoox keys over nested legacy paths.

Legacy: config secrets / config keys still work; prefer hoox secrets and hoox keys.

Flags — check to add to commands
[ Configure ]02

hoox secrets

Preferred secrets surface. List, set, delete, and sync encrypted worker secrets (.dev.vars ↔ Cloudflare®).

Prefer --system after key rotation. Full sync reports synced / skipped (placeholders) / failed.

Flags — check to add to commands
[ Configure ]03

hoox keys

Internal auth keys for inter-worker communication. Written under .keys/ (gitignored).

[ Configure ]04

hoox schema

Validate worker wrangler.jsonc against canonical manifests; list bindings; generate configs.

Flags — check to add to commands
05

Verify

4 groups
[ Verify ]01

hoox check

Validate toolchain, full setup, worker health endpoints, and auto-fix common issues.

Flags — check to add to commands
[ Verify ]02

hoox doctor

Diagnose global runtime: HOOX_HOME, remembered monorepo path, TUI entry, optional operator-plane security probes.

Resolution order: HOOX_REPO → walk-up from cwd → ~/.hoox/config/monorepo.json → ~/.hoox/repo. Prints Remembered, Runtime root, and Source.

Flags — check to add to commands
[ Verify ]03

hoox repair

Diagnose and heal: redeploy workers, provision missing infra, re-sync secrets/KV, re-apply DB, full rebuild.

Flags — check to add to commands
[ Verify ]04

hoox test

Verification pipeline: lint → typecheck → unit → integration, plus live Cloudflare® service tests.

Flags — check to add to commands
06

Data

2 groups
[ Data ]01

hoox db

D1 administration: apply schema, migrations, list tables, query SQL, export, destructive reset.

Flags — check to add to commands
[ Data ]02

hoox pyne

Operate the Python pyne-worker isolate — Pine Script™ edge evaluate (health, run, scripts, cron, feed, ingest, vendor, deploy).

This is the pyne-worker operator surface — not the desk `pyne` Click CLI (that lives on PYNE / pip install hoox-pyne).

Flags — check to add to commands
07

Observe

5 groups
[ Observe ]01

hoox monitor

Ops controls: recent trades, D1 system logs, kill-switch, queue depth, D1 backup, analytics rollups.

Flags — check to add to commands
[ Observe ]02

hoox logs

Live Cloudflare® Worker log tail for one worker or all enabled workers.

Flags — check to add to commands
[ Observe ]03

hoox trace

Cloudflare® Workers Observability (beta): spans, metrics, live tail, filter keys, OTLP destinations, usage.

Flags — check to add to commands
[ Observe ]04

hoox perf

Probe-based fast-path latency: batch run (p50/p95/p99), continuous tail, historical report from observability.

Flags — check to add to commands
[ Observe ]05

hoox agent

AI agent ops — probe multi-provider model gateway health.

Flags — check to add to commands
08

Security

2 groups
[ Security ]01

hoox waf

Cloudflare® WAF: status, firewall rules (allow/block/rate-limit/custom), enable/disable mode on zone.

[ Security ]02

hoox tunnel

Private ingress helpers for operator management paths (Cloudflare® Tunnel + Access). Optional — many deployments only need Access on a mgmt hostname.

Pairs with hoox doctor --security and hoox config transport (public | access | mtls | tunnel).

Flags — check to add to commands
09

Meta

2 groups
[ Meta ]01

hoox completion

Generate shell completion scripts for bash, zsh, or fish.

[ Meta ]02

hoox disclaimer

Print legal disclaimers and trademark information.

Command Groups30
Categories9
Subcommands130+
Test Files67
hoox onboard → hoox deploy all --auto → Trading Live