Caddi
Sign inSign up

caddi link

Already have a repo and a Vercel project? caddi link adopts them into Caddi — without touching your code.

Usage

bash
caddi link [flags]

Common invocations

bash
# Run inside an existing checkout
cd ~/code/meridian-studio
caddi link

# Specify everything up front
caddi link \
  --gh-repo northstar/meridian-studio \
  --vercel-project meridian-studio \
  --client meridian \
  --prod-branch main \
  --staging-branch staging \
  --dev-branch dev

What it does

  • Reads the repo origin and the Vercel project linked to it.
  • Asks which branches map to production, staging, and dev. Creates the missing branches if you want.
  • Pulls the existing env vars from Vercel into the Caddi env-var store.
  • Writes a .caddi/config.json to the repo root.

What it doesn’t do

  • It does not move env vars off Vercel — they remain the source of truth.
  • It does not rewrite your branches.
  • It does not install @caddi/forms-sdk or AGENTS.md — see Create your own template for the recipe.
If the repo has fewer than three long-lived branches, Caddi can create the missing ones for you. We default to main / staging / dev but every name is configurable.

Next

caddi env →