Closed beta — join the waiting list
Getting StartedDeployingCustom DomainsEnvironment VariablesDatabaseCLI ReferenceAPI ReferenceMCP Integration

CLI Reference

Complete reference for the Hatch command-line interface.

hatch create

Create a new Hatch app and get a git remote URL.

hatch create <app-name>

Output:
  App created: myapp
  Git remote: https://git.hatch.sh/myapp.git

  Add the remote and deploy:
    git remote add hatch https://git.hatch.sh/myapp.git
    git push hatch main

hatch status

View the status of a deployment.

hatch status [--project <name>]

Output:
  Project:    my-app
  Status:     live
  URL:        https://my-app.hatch.sh
  Deployed:   2 minutes ago
  Runtime:    Node.js 20
  Region:     eu-west

hatch logs

Stream or view deployment logs.

hatch logs [--project <name>] [options]

Options:
  --follow, -f          Stream logs in real-time
  --lines <n>           Number of lines to show (default: 100)
  --since <duration>    Show logs since duration (e.g. 1h, 30m)

hatch env

Manage environment variables.

hatch env set <KEY=VALUE> [KEY=VALUE...] --project <name>
hatch env list --project <name>
hatch env remove <KEY> --project <name>

hatch domains

Manage custom domains.

hatch domains add <domain> --project <name>
hatch domains list --project <name>
hatch domains remove <domain> --project <name>

hatch login / logout

Manage authentication.

# Log in via GitHub OAuth
hatch login

# Log out and clear local credentials
hatch logout

# Show current auth status
hatch whoami
Hatch mascot