Caddi docs
Caddi is the caddie for your coding agent — where your AI-built projects live. These docs cover every surface: CLI, agents, templates, environments, domains, pinpoints, forms, the client portal, billing, and security.
New here? Start with Getting started — about ten minutes to a deployed first project. Looking for a specific command? Jump to CLI.
Getting started
Overview
What Caddi is, who it’s for, and the 60-second tour.
Agency setup
Sign up, pick a slug, 2FA, invite teammates.
Install the CLI
npm i -g @caddi/cli and caddi login.
Connect GitHub
Install the GitHub App on the org you build in.
Connect Vercel
OAuth or PAT — Caddi only needs deploy access.
Your first project
Pick a template, scaffold three envs, ship it.
CLI
Overview
The 10 commands you’ll actually use.
caddi init
Scaffold a project from a template.
caddi link
Adopt an existing repo into Caddi.
caddi deploy
Push the current branch and wait for the deploy URL.
caddi env
List, set, unset, copy env vars.
caddi promote
Open the promotion PR from one env to the next.
caddi domains
Attach a domain, watch the verification.
caddi requests
Read and reply to client requests from the terminal.
caddi logs
Tail Vercel logs for the current env.
caddi listen
Install and run the Caddi Auto daemon.