Commands

Reference for zectre CLI commands — deploy, projects, env, logs, and local dev.

Global flags (all subcommands)

Flag / envEffect
--api-url / ZECTRE_API_URLCluster API base URL for this process
--api-key / ZECTRE_API_KEYAPI key (overrides Bearer token when set)
--cluster / ZECTRE_CLUSTER_IDUse .zectre/<id>/ link state
--project-id / ZECTRE_PROJECT_IDOverride project UUID from project.json

Top-level

CommandDescription
zectreDeploy current directory (default action)
zectre loginAuthenticate (catalog OAuth when ZECTRE_CATALOG_URL / catalog_url set, else legacy)
zectre logoutClear authentication
zectre whoamiCurrent user
zectre linkLink cwd to a platform project
zectre projects listList projects
zectre projects create <name>Create project
zectre projects add [name]Create and link
zectre projects get <project>Show one project by name or ID (--json optional)
zectre projects delete <id>Delete project
zectre devLocal run (Tish runtime shells out to tish)
zectre buildLocal compile (Tish runtime)
zectre deployDeploy to platform
zectre logs <task-id>Stream logs
zectre env listList app environment variables
zectre env add <key> <value>Add var (--secret for secrets)
zectre env remove <key>Remove var
zectre env pullPull vars to .env
zectre statusDeployment status

Local dev / build (Tish)

zectre dev --source src/main.tish
zectre dev --watch
zectre build --source src/main.tish --output ./dist/app
zectre build --features http --features fs

Deploy variants

zectre deploy --wait
zectre deploy --prod

Env management

zectre env list
zectre env list --show-values
zectre env add LOG_LEVEL debug
zectre env add API_KEY secret --secret
zectre env remove API_KEY
zectre env pull -o .env --environment production

See Configuration for flags and environment variables.