deployhq-cli

DeployHQ from your terminal -- for humans and agents.

Install

Homebrew (macOS/Linux)

brew install deployhq/tap/dhq

Script (macOS/Linux)

curl -fsSL https://deployhq.com/install/cli | sh

Scoop (Windows)

scoop bucket add deployhq https://github.com/deployhq/scoop-bucket
scoop install dhq

Go

go install github.com/deployhq/deployhq-cli/cmd/dhq@latest

Binary

Download from Releases (Linux, macOS, Windows — amd64/arm64).

Updating

dhq update

Install as an agent skill (skills.sh)

Add the DeployHQ skill to any supported AI agent (Claude Code, Cursor, Codex, Gemini CLI, Copilot, and more) directly from this repo:

npx skills add deployhq/deployhq-cli

(This is the cross-agent equivalent of dhq skills install, for users discovering DeployHQ through the skills.sh directory.)

Quick Start

# One command: detect the framework, provision DeployHQ hosting
# (Static Hosting or a Managed VPS) and deploy — to a live URL.
dhq launch

# Guided setup (login or signup, pick a project, install the DeployHQ
# skill into your AI coding agents, optional first deploy)
dhq hello

# Or step-by-step
dhq signup
dhq auth login
dhq configure

# Teach your detected AI coding agents (Claude Code, Cursor, Codex, …) to drive dhq
# (project-scope agents like Copilot are opt-in — see `dhq skills install --agent`)
dhq skills install

# Deploy and watch in real-time
dhq deploy -p my-app --wait

# Check deployment logs
dhq deployments logs <id> -p my-app

# Open in browser
dhq open my-app

One-command deploy (dhq launch)

dhq launch takes a project folder to a live URL on DeployHQ's own infrastructure — Static Hosting (global CDN, Cloudflare-backed) or a Managed VPS (DeployHQ-provisioned) — in a single command. It detects your framework, provisions the target, deploys, and prints the URL.

dhq launch                    # interactive: detect, pick a target, deploy
dhq launch --static --subdomain my-app
dhq launch --vps --accept-cost --region lon1 --size s-1vcpu-1gb

# Agents / CI — structured JSON, never prompts:
dhq launch --static --json
dhq launch --vps --dry-run --json   # preview cost + actions, no side effects

A Managed VPS is a managed resource — free for early customers during the beta, billed monthly afterwards — so --accept-cost is required for non-interactive VPS provisioning (--yes alone never provisions one). After the first run, launch writes .deployhq.toml so subsequent deploys are just dhq deploy. See the agent guide for the full flag set and the structured-error reasons agents can branch on.

Authentication

# Interactive login (stores in OS keyring)
dhq auth login

# Environment variables (CI/agents — no login needed)
export DEPLOYHQ_API_KEY=your-api-key
export DEPLOYHQ_ACCOUNT=your-account
export DEPLOYHQ_EMAIL=your-email

CI/CD (GitHub Actions)

No dhq auth login needed — set secrets and go:

# .github/workflows/deploy.yml
env:
  DEPLOYHQ_ACCOUNT: ${{ secrets.DEPLOYHQ_ACCOUNT }}
  DEPLOYHQ_EMAIL: ${{ secrets.DEPLOYHQ_EMAIL }}
  DEPLOYHQ_API_KEY: ${{ secrets.DEPLOYHQ_API_KEY }}
  DEPLOYHQ_PROJECT: my-app

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - run: curl -fsSL https://deployhq.com/install/cli | sh
      - run: dhq deploy --server production --revision ${{ github.sha }} --wait --json

See examples/github-actions/ for complete workflows:

• deploy.yml — Deploy on push to main with polling and failure logs
• deploy-multi-env.yml — Staging on push, production on release, auto-rollback
• deploy-on-pr-merge.yml — Deploy on PR merge with status comment on the PR

This is the beginning of the README. Read the rest at the original. Read the full README ↗