Caddi
Sign inSign up

caddi deploy

Push the current branch. Trigger a Vercel build. Wait for the deploy URL. Return it. That’s the whole command.

Usage

bash
caddi deploy [flags]

Example

bash
caddi deploy

# pushing dev → origin
# build queued     #2014  meridian-studio-git-dev
# building...      [▇▇▇▇▇▇▇▇░░░░] 67%
# ready            https://meridian-dev.preview.northstar.dev

Flags

  • --no-wait — push and return immediately. Prints the build URL.
  • --message <text> — extra context attached to the audit log entry.
  • --force — allow pushing to main or staging directly. Skips the “use caddi promote” warning.
By default, deploying from main or staging is blocked — use caddi promote instead. --force is for hotfixes only and logs a loud audit entry.

What happens under the hood

  • Caddi runs git push origin <current-branch>.
  • Vercel receives the push webhook and starts a build (Caddi doesn’t trigger the build directly — your repo settings drive that).
  • The CLI polls Vercel until the deploy is READY or fails.
  • On failure, the CLI prints the build log URL and exits non-zero. Useful in CI scripts.

Scripting

bash
URL=$(caddi deploy --json | jq -r .url)
echo "Deployed to $URL"

Next

caddi promote →