CLI Commands

Complete reference for all Hatch commands.

hatch setup

One-time setup. Configures the system DNS resolver, starts the daemon, and installs a trusted certificate authority. Requires sudo.

hatch add <domain> <port>

Map a local domain to a port.

--httpsEnable HTTPS with a trusted certificate
--project <path>Associate with a project directory

hatch rm <domain>

Remove a domain mapping.

hatch ls

List all domain mappings with their port, status (active/stopped), and HTTPS state.

hatch scan

Detect all running services on common ports, identify project types (Node, Go, Rust, Python), and suggest domain mappings.

hatch start

Start the Hatch daemon (DNS server + reverse proxy).

hatch stop

Stop the Hatch daemon.

hatch status

Check daemon health — shows whether the DNS server and proxy are running.

hatch config

Show the current configuration.

hatch config set <key> <value>

Update a configuration value.

hatch logs

View daemon logs.

--follow, -fStream logs in real-time

hatch open <domain>

Open a mapped domain in your default browser.