CLI Reference

[CLI REFERENCE]

28 groups · 119+ subcommands. Bare hoox launches the TUI.

@jango-blockchained/hoox-cli • v0.9.4 • 58 test files

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:
--token <token>Cloudflare API token
--account <id>Cloudflare account ID
--preset <name>minimal | standard | full
--resumeResume interrupted onboard
--accept-riskAccept trading risk disclaimer
--skip-keysSkip internal key generation
--skip-dbSkip D1 schema apply
--skip-secretsSkip secret upload
--skip-dashboardSkip dashboard deploy
--database <name>Target D1 database name
[ Onboard ]02

hoox init

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

Flags:
--token <token>Cloudflare API token
--account <id>Cloudflare account ID
--preset <name>minimal | standard | full
--resumeResume interrupted wizard
--accept-riskAccept trading risk disclaimer
[ Onboard ]03

hoox setup

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

Flags:
--skip-keysSkip key generation
--skip-dbSkip D1 schema
--skip-secretsSkip Cloudflare secrets
--skip-dashboardSkip dashboard rebuild
--dry-runPreview without changes
--database <name>Target D1 database
-y, --yesNon-interactive
[ Onboard ]04

hoox clone

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

Flags:
--allClone all workers
--homeClone into $HOME/.hoox/workers
--org <org>GitHub org (auto-detected by default)
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:
--runtime <mode>native | docker
--port <port>Port for single worker
[ Develop ]02

hoox dashboard

Dashboard shortcuts. Delegates to dev dashboard / deploy dashboard.

Flags:
--rebuildForce rebuild before deploy
--autoSkip confirmations on deploy
[ Develop ]03

hoox tui

OpenTUI terminal operations center. Also launched when you run hoox with no args and wrangler.jsonc exists.

Flags:
--fps <n>Frame rate (default 30)
--no-mouseDisable mouse input
[ 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:
--env <env>Target environment
--rebuildForce full rebuild
--autoSkip confirmation prompts
--dry-runPreview without deploying
[ Ship ]02

hoox infra

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

Flags:
--dry-runPreview provision only
[ 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.

Flags:
--namespace-id <id>KV namespace for config kv *
[ Configure ]02

hoox secrets

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

[ 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:
--dry-runPreview generate only
05

Verify

3 groups
[ Verify ]01

hoox check

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

Flags:
--fixAuto-fix on health failure
--dry-runPreview repairs
--tool <name>Single prerequisite tool
[ Verify ]02

hoox repair

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

Flags:
--install-depsInstall deps during check
--no-typecheckSkip typecheck in check
[ Verify ]03

hoox test

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

Flags:
--coverageCoverage report
--jsonJSON output (all)
--service <name>Live service filter
06

Data

2 groups
[ Data ]01

hoox db

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

Flags:
--database <name>Target D1 database
--remoteOperate on production D1
--file <path>Schema file for apply
--allow-destructiveAllow destructive SQL in query
--confirmConfirm reset
--output <path>Export path
[ Data ]02

hoox pine

Pine Script tooling: download Binance OHLCV, backtest strategies, export chart data, bundle libraries for deploy.

Flags:
-s, --symbolTrading pair (e.g. BTCUSDT)
--tf <timeframe>Candle timeframe
-d, --days <n>History window
-a, --allAll default symbols (download)
-b, --bars <n>Bar count (backtest/export)
--csvCSV output for export
07

Observe

5 groups
[ Observe ]01

hoox monitor

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

Flags:
--hours <n>Window for analytics errors (default 24)
[ Observe ]02

hoox logs

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

Flags:
--level <level>Log level filter
--follow / --no-followStream control
--jsonJSON log lines
[ Observe ]03

hoox trace

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

Flags:
--service <name>Filter by worker
--level <level>Event level
--from / --toTime window
--limit <n>Result limit
[ Observe ]04

hoox perf

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

Flags:
--n <count>Probe count (run)
--concurrency <n>Parallel probes
--duration <s>Tail duration
--interval <ms>Tail interval
--symbol / --action / --quantityProbe payload
--timeout <ms>Per-probe timeout
--api-key <key>Auth for probes
[ Observe ]05

hoox agent

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

08

Security

1 group
[ Security ]01

hoox waf

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

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 Groups28
Categories9
Subcommands119+
Test Files58
hoox onboard → hoox deploy all --auto → Trading Live