Commands
Reference for zectre CLI commands — deploy, projects, env, logs, and local dev.
Global flags (all subcommands)
| Flag / env | Effect |
|---|---|
--api-url / ZECTRE_API_URL | Cluster API base URL for this process |
--api-key / ZECTRE_API_KEY | API key (overrides Bearer token when set) |
--cluster / ZECTRE_CLUSTER_ID | Use .zectre/<id>/ link state |
--project-id / ZECTRE_PROJECT_ID | Override project UUID from project.json |
Top-level
| Command | Description |
|---|---|
zectre | Deploy current directory (default action) |
zectre login | Authenticate (catalog OAuth when ZECTRE_CATALOG_URL / catalog_url set, else legacy) |
zectre logout | Clear authentication |
zectre whoami | Current user |
zectre link | Link cwd to a platform project |
zectre projects list | List 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 dev | Local run (Tish runtime shells out to tish) |
zectre build | Local compile (Tish runtime) |
zectre deploy | Deploy to platform |
zectre logs <task-id> | Stream logs |
zectre env list | List app environment variables |
zectre env add <key> <value> | Add var (--secret for secrets) |
zectre env remove <key> | Remove var |
zectre env pull | Pull vars to .env |
zectre status | Deployment 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 fsDeploy variants
zectre deploy --wait
zectre deploy --prodEnv 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 productionSee Configuration for flags and environment variables.