Command reference
Every clouzark command and its options.
Run clouzark <command> --help for the same information in your terminal. List commands accept --json.
Account
| Command | Does |
|---|---|
login [--token <pat>] [--api-url <url>] [--no-browser] | Log in through the browser, or with an access token |
logout | Revoke this machine's token and forget it |
whoami | Show the user, team, and API |
init [--no-agents] | Link hosting and database, and write a Clouzark section into AGENTS.md |
link [-p <ref>] [-y] / unlink | Link this directory to a hosting project |
mcp [--read-only] [-p <ref>] [--db <ref>] | Run as an MCP server for coding agents (AI agents) |
Web hosting
| Command | Does |
|---|---|
projects ls | List the team's hosting projects |
projects memory [size] [-p <ref>] | Show or set the app's instance size: 512mb, 1gb, 2gb, 4gb, or default |
projects database [-p <ref>] [--json] | Show the linked database whose URL and keys are injected as env vars |
projects database link [--db <ref>] [-p <ref>] / projects database unlink | Link a database (the one linked to this directory by default), or unlink it; applies from the next deployment |
projects sync-repo [-p <ref>] | Follow a GitHub repo rename or transfer: point the project at the repo's current URL. A ref and app URL made from the old repo name move to the new name; the old URL redirects |
projects create [repo] [-n <name>] [--root <dir>] [--framework <f>] [--production-branch <b>] [--no-link] [--no-wait] | Import a GitHub repo as a project (this repo's origin by default), link it, and follow the first production build |
deploy [--prod] [-b <branch>] [--force] [--no-wait] | Build a branch's latest pushed commit and stream the log; --force builds without the build cache |
deploy --upload [--prod] [--force] | Build this directory as it is now |
deployments ls [-n <limit>] | Recent deployments |
logs [deploymentId] [-f] | Show or follow a build log (the latest deployment by default) |
promote <deploymentId> | Make a deployment the live production deployment |
rollback | Roll production back to the previous live deployment |
redeploy [deploymentId] [--force] [--no-wait] | Rebuild with the current environment variables; --force skips the build cache |
cancel <deploymentId> | Cancel a queued deployment |
env ls | List variable names, targets, and branches |
env add <KEY> [value] [-t all|production|preview] [-b <branch>] | Add or update a variable (prompts for the value if omitted). -t preview -b dev scopes it to the dev branch |
env rm <KEY> [-t ...] [-b <branch>] | Remove a variable |
env pull [file] [-e production|preview] [-b <branch>] [-y] | Write resolved values to a file (.env.local by default). -b includes that branch's own preview values |
domains ls | List custom domains |
domains add <hostname> [-b <branch>] [--preview] | Add a domain and print the DNS records to create. -b serves that branch instead of production |
domains route <hostname> --production|--preview|-b <branch>|--redirect <host> [--status 308] | Change what a domain serves |
domains verify <hostname> | Check DNS and issue the certificate |
domains rm <hostname> | Remove a domain |
import vercel [--team <name>] [--project <name>...] [--all] [--dry-run] [-y] | Migrate Vercel projects: repo, build settings, env vars, domains, and crons. Reads VERCEL_TOKEN, or asks |
crons ls [--json] | List cron jobs, from clouzark.json and the CLI, with their last and next runs |
crons add <name> <path> <schedule> [-m GET|POST] [--tz zone] [--timeout s] [--retries n] [--disabled] | Call a path on the production app on a schedule |
crons edit <job> [--path p] [-s schedule] [-m method] [--tz zone] [--timeout s] [--retries n] [--name new] | Change only what you pass (not for jobs from clouzark.json) |
crons enable <job> / crons disable <job> | Resume or pause scheduled runs |
crons run <job> | Call it now and wait for the response |
crons runs <job> [-n 20] [--json] | Recent runs: status, HTTP code, duration, response |
crons rm <job> [-y] | Delete a job and its run history |
Database
| Command | Does |
|---|---|
db ls | List database projects |
db create <name> [--no-link] | Create a database (and link it) |
db delete <ref> [-y] | Permanently delete a database |
db link [--db <ref>] | Link this directory to a database |
db query [sql] [-f file] [--json] | Run SQL from an argument, a file, or stdin |
db url [--pooled] [--json] | Print the direct connection string, or with --pooled the connection pooler's (port 6543, for apps and serverless) |
db keys [--json] | Print the REST URL, anon key, and service key |
db dump [-f file] [--data-only|--full] | Dump with your local pg_dump (schema only by default) |
db backups ls [--json] | List backups, newest first: nightly, manual, and pre-restore |
db backups create | Back up now and wait until it's done |
db backups download <id> [-o file] | Download a backup as a pg_dump custom-format archive |
db backups restore <id> [-y] | Replace the database with a backup (a safety backup is taken first) and wait |
import supabase [-n name] [--dry-run] [-y] [--no-link] | Migrate a Supabase project: database, auth users, policies, and storage into a new database. Reads SUPABASE_DB_URL, SUPABASE_URL, and SUPABASE_SERVICE_ROLE_KEY, or asks |
migration new <name> | Create clouzark/migrations/<timestamp>_<name>.sql |
migration ls | Compare local migrations with the applied ones |
db push [--dry-run] [-y] | Apply pending migrations |
gen types typescript [-o file] [-s schemas] | Generate TypeScript types for the public schema, or the comma-separated schemas given with --schema |
db cron ls [--json] | List cron jobs with their last and next runs |
db cron add <name> <schedule> [sql] [-f file] [--tz zone] [--timeout s] [--disabled] | Schedule SQL; schedule is 5-field cron, e.g. "0 3 * * *" |
db cron edit <job> [sql] [-s schedule] [-f file] [--tz zone] [--timeout s] [--name new] | Change only what you pass |
db cron enable <job> / db cron disable <job> | Resume or pause scheduled runs |
db cron run <job> | Run now and wait for the result |
db cron runs <job> [-n 20] [--json] | Recent runs: status, duration, message |
db cron rm <job> [-y] | Delete a job and its run history |