Caddi
Sign inSign up

caddi promote

Move work forward through the environment chain. dev → staging or staging → production. Always through a PR.

Usage

bash
caddi promote <from> <to>

Examples

bash
# dev → staging
caddi promote dev staging

# staging → production (the most common one)
caddi promote staging production --message "Launch the new pricing page"

What it does

  • Opens a GitHub PR from <from> into <to>.
  • Auto-generates a change summary from the commit log since the last promotion.
  • Attaches the deploy URL of the source environment as the PR description preview.
  • Watches the resulting Vercel deploy and prints the live URL when ready.
  • Writes the SHA into the project’s promotion history (used by revert).

Output

bash
caddi promote staging production

# PR opened       https://github.com/northstar/meridian-studio/pull/412
# summary
#   feat: new pricing page
#   fix: footer email link
#   chore: bump @caddi/forms-sdk
# merging...      ✓
# deploy queued   #2018
# ready           https://meridian.studio

Approval gates

If the project has a client-approval gate on this transition (Pro), the PR is opened but merge is held until the client approves in the portal:

bash
# awaiting client approval...   ([email protected] notified)
# approved by [email protected] at 2026-05-12T14:22:09Z
# merging...     ✓

See Approval gates.

If your repo requires PR reviews via branch protection, Caddi surfaces the missing reviews on the promotion screen rather than failing. The CLI exits with code 2 and prints what’s blocking.

Next

Revert →