platform>docssolutionspricingcontact

Linking & projects

How zectre associates your repo with a platform project and how multi-cluster folders work.

zectre link

Interactive pick of project, or --project <name>. Use --cluster <id> to store state under .zectre/<id>/ (creates cluster.json + project.json).

Add (create + link)

zectre projects add my-app

Bare zectre or zectre deploy in an unlinked directory prompts to link or create (TTY only). In CI, run zectre link or zectre projects add first and set ZECTRE_CLUSTER_ID if needed.

Multiple clusters

Each clusterId folder under .zectre/ can point at a different API URL (e.g. local, prod). The CLI picks the right folder by:

  • --cluster / ZECTRE_CLUSTER_ID
  • Matching ZECTRE_API_URL to a stored apiUrl
  • Interactive prompt when ambiguous

Overrides for one shot

Flag / envEffect
--api-url / ZECTRE_API_URLHTTP base for this invocation
--project-id / ZECTRE_PROJECT_IDOverride project UUID (name/namespace still from project.json)

Delete a project

zectre projects delete <id>

See also Configuration for file layouts.