Command Reference
Complete list of all available CLI commands.
| Command | Description |
|---|---|
| leash login | Sign in with Google (opens browser) |
| leash logout | Sign out and clear stored credentials |
| leash whoami | Show current authenticated user and plan |
| leash init | Bootstrap an app and write .leash/config.json (commit this to git) |
| leash dev | Run your dev server with org secrets injected as env vars |
| leash dev -- <command> | Run an explicit command (e.g. npm run start) with secrets injected |
| leash secrets types | TypeScript only — generate leash-secrets.d.ts typing process.env from configured keys |
| leash deploy | Deploy current directory (auto-detects framework, auto-syncs secrets) |
| leash deploy --html <file> | Deploy a single HTML file as a static site |
| leash apps | List all deployed apps with URLs and status |
| leash apps delete <name> | Delete a deployed app permanently |
| leash status <app> | One-line status for an app (--wait polls until active, --json for JSON) |
| leash logs [app] | Tail your app's stdout/stderr from Cloud Run |
| leash rollback [app] | Shift traffic back to the previous revision of your app |
| leash db shell <app> | Open a psql session against the app’s managed database |
| leash integrations list | List configured third-party integrations |
| leash integrations connect <name> | Connect an integration via OAuth |
| leash integrations disconnect <name> | Disconnect an integration (--yes to skip prompt) |
| leash coupons redeem <code> | Redeem a coupon code for credits |
| leash org list | List organizations you belong to |
| leash org use <slug> | Switch the active organization |
| leash version | Show CLI version |
leash logs
Tail your app's stdout/stderr from Cloud Run. Defaults to the cwd's app (read from .leash/config.json); pass <app> to target another.
Terminal
$ cd ~/projects/my-app && leash logs -f
| Flag | Description |
|---|---|
-f, --follow | Stream new lines as they happen. |
--limit=N | Non-follow mode; default 200. |
Available on all plans. Platform noise (startup probes, scheduler chatter) is filtered out — you only see your app's output. See Operations → Tailing logs for the recipe.
leash rollback
Requires Growth plan or above.
Shift traffic back to the previous revision of your app. Defaults to the cwd's app.
Terminal
$ leash rollback
| Flag | Description |
|---|---|
--yes | Skip the confirmation prompt (for CI / agentic use). |
Leash retains the last 10 deployed revisions per app. See Operations → Rolling back for the recipe.