# Hosted HTML Review CLI Use the `html-collab-host` CLI for Hosted HTML Review operations. Check every command's exit code; stop on unhandled errors. Use `--json` for structured operation results. ### Install Current release: **0.15.0**. Requirements: Node.js 22 or later, npm, an available native operating-system credential store, and a publishing account. Register and verify your email in the browser first when signup is open. Registration can pause or reach the initial 15-publisher limit. The CLI supports macOS, Windows and Linux; it is not limited to Apple Keychain. Native credential storage must be available on the machine running the CLI, including when using device login from a remote terminal. Browser users do not need to install the CLI. ```sh node --version npm --version npm install --global html-collab-host html-collab-host --help ``` If Node is missing or older than 22, use the existing runtime manager to install a supported version before installing the CLI. The default API endpoint is `https://hosted-html-review-production.zacco16.workers.dev`, which serves the same production service as `https://html-host.com`. If `HTML_COLLAB_HOST_API` is set, confirm that it selects the intended environment and retain it for subsequent commands. From CLI 0.13.3 it must be an `https://` URL; plain `http://` works only for `127.0.0.1`, `::1` or `localhost`. If a command fails with `VALIDATION_FAILED` naming `HTML_COLLAB_HOST_API`, correct or unset the variable and rerun the command. ### Authenticate ```sh html-collab-host auth status --json ``` If the result reports `authenticated: true`, continue. On `AUTH_REQUIRED`, run: ```sh html-collab-host auth login ``` Let the user complete the authorization flow opened by the command. Continue only after login succeeds. For a remote or SSH terminal, use: ```sh html-collab-host auth login --device ``` The CLI manages credential storage and refresh. If the operating-system credential service is locked or unavailable, ask the user to unlock or enable it. Keep codes and credentials out of logs; do not substitute plaintext credential storage. ### Install agent Skills Preview the links first: ```sh html-collab-host skills link --dry-run --json ``` After a successful dry run, apply them: ```sh html-collab-host skills link --json ``` Preserve existing Skills if a conflict is reported. npm installation alone does not link Skills. The linker uses existing agent skill roots and falls back to `.agents/skills` when none are populated. For project-local copies, run `html-collab-host skills install --json` from the project instead. Read `html-collab-share/SKILL.md` for publishing, access, and feedback, or `html-collab-manage/SKILL.md` for inspection and administration. Load only the linked operation guide needed for the task. Both skills use the existing CLI and share an authentication guide. If newly linked Skills are not discoverable, reload the agent session or read the files at the installer's returned paths. ### Verify setup ```sh html-collab-host auth status --json html-collab-host artifacts --limit 1 --json ``` Setup is complete when the CLI runs, the requested Skills are linked or installed, authentication reports `authenticated: true`, and the Artifact read succeeds. An empty list is valid. Report incomplete steps and non-secret errors instead of claiming success. Stop after this read-only check unless the user requested another operation. ### Run requested operations Use the installed operation Skill and `--json`. Retain returned Artifact and Version identifiers and verify the result. Read the current Version before updating an existing Artifact; use `feedback prepare` to retrieve verified source for feedback edits. For a requested first publication, replace the file path, title, slug, and idempotency key with values for that operation: ```sh html-collab-host publish report.html --title "My report" --slug my-report --idempotency-key unique-publish-key --json ``` Reuse an idempotency key only when retrying the same intent and payload. New Artifacts are private by default; use the sharing Skill only when the user requests access changes. Use `html-collab-host --help` for command options. ### CLI support Support: [stas.support@gmail.com](mailto:stas.support@gmail.com). Include the command, installed CLI version, operating system, and non-secret error text when reporting a problem. Send email only when the user requests it.