CLI Reference

Deploy a pre-built app directory. Creates the egg if it doesn't exist.

Flags: --name, --deploy-target, --runtime, --start-command, --domain

Restart a running egg.

Permanently delete an egg.

Flags: --yes to skip confirmation

Configure the CLI with an API token.

Authenticate via browser OAuth.

Log out and clear local credentials.

Show current authentication status.

List your API keys.

List all your eggs.

Show detailed egg information.

View egg logs.

Flags: --build for build logs, --follow / -f for streaming, --lines / -n number of lines

Open egg in your browser.

Show energy status (account-wide or per-egg), including daily, weekly, bonus and pack balances.

Buy an Energy Pack — prints a Stripe Checkout URL; minutes are credited when the payment completes.

Boost an egg with extra energy.

Show the egg's CPU/memory limits (runtime profile or override).

Override the egg's memory limit (capped by tier: free 512 MB, Always On 1024 MB).

Register a scheduled task on your egg. The schedule is 5-field cron syntax (UTC); the command after -- runs on that schedule inside your egg's last deployed image.

Example: hatch cron add "*/5 * * * *" -- npm run digest

List scheduled tasks for your egg with their schedule, command, enabled state, last-run status, and next run.

Show stdout/stderr for a cron's runs (latest run by default).

Flags: --run <run-id> show a specific run

Delete a scheduled task and remove its periodic job.

Set environment variables.

Flags: --from-env / -f import from a .env file

Remove environment variables.

List environment variables with full secret values visible (passwords, tokens, keys are masked by default).

Provision a PostgreSQL database for your egg. Free tier: 50 MB, 10,000 rows.

Open a local TCP proxy to your egg's database and auto-launch psql.

Flags: --port / -p local port (default 15432), --host local address, --no-psql tunnel only

Show database status and usage for your egg.

Provision a persistent volume mounted at /data. Takes effect on the next deploy.

Flags: --size volume size in MB (default 1024), --app / -a egg slug

Show volume size, usage and mount point.

Detach the volume and delete it after a 7-day grace period.

Flags: --now delete immediately and irreversibly (skips the grace period)

Add a custom domain to your egg. Outputs DNS records and verification token.

Verify domain ownership via DNS TXT record and activate routing.

List custom domains and their verification status.

Remove a custom domain.

Deploy a preview environment (e.g. pr-42) for the current app. Repeat deploys update in place.

Flags: --json machine-readable output with the preview URL

List the app's preview environments with status and expiry.

Tear down a preview immediately.

Register an outbound deploy webhook. The signing secret is shown once.

Flags: --events (default deploy)

List webhooks with last delivery status.

Remove a webhook.

Send a signed ping event to verify your receiver.

Start the MCP tool server for AI assistants.

Print the CLI version.