host0
Get started
All updates
New

The host0 CLI: deploy and manage apps from your terminal

·1 min read

A terminal running npx @host0/cli deploy ./launch-site, which prints the live URL and publish_result lines, then host0 ls listing seven apps with their access and URLs.

host0 now has a command-line tool. One command publishes a folder or a single file and prints its URL:

Terminal
npx @host0/cli deploy ./site

Or install it once with npm i -g @host0/cli and run host0 deploy ./site. It needs Node 18.18 or newer and has no dependencies.

With no API key, deploy starts a device login: it prints a link and a short code, you approve it on host0 in your browser, and you run the same command again. Nothing personal is typed into the terminal.

Everything else is one command too#

  • host0 ls and host0 inspect <app> to see your apps, their access and live version
  • host0 versions <app> and host0 rollback <app> <version> to undo a bad deploy
  • host0 visibility <app> private|link|public, host0 share <app> <email> and host0 unshare
  • host0 rename <app> --slug <new-url> for a readable address
  • host0 analytics <app> and host0 records <app> --export
  • host0 pull <app> to download the live files into a folder, edit them and deploy the next version

host0 pull q4-roadmap downloads the live files, then host0 deploy publishes the edited folder as version 8, uploading only the changed file.

Add --json to any control command to get the API's response unchanged.

Works with the host0 skill#

The CLI uses the same credentials file, per-folder state and output lines as the skill's publish.sh, so an agent can switch between them in the middle of a project. Coding agents that have the host0 skill now prefer the CLI when Node is available. The full reference is in the docs.

All updates