Caddi
Sign inSign up

Install the CLI

@caddi/cli is how you scaffold, deploy, promote, and tail logs without leaving the terminal. The dashboard is optional once you’ve got it.

Install

bash
npm i -g @caddi/cli
# or
pnpm add -g @caddi/cli

Node 18+ is required. The binary is named caddi.

Log in

bash
caddi login

# opens https://app.caddi.build/cli?code=ABCD-1234 in your browser
# paste the code, confirm, and the CLI writes a token to ~/.caddi/config.json

The token is scoped to your user. Revoke it any time from Settings → CLI tokens.

Verify

bash
caddi whoami

# [email protected]  ·  agency: northstar  ·  role: owner

Default agency

If you belong to more than one agency, set the default for the current shell:

bash
caddi use northstar
You can override per-command with --agency <slug>.

Updating

bash
caddi upgrade
# or
npm i -g @caddi/cli@latest

Next

Connect GitHub →