Instruction file imported from zitadel/nextgen (
.github/instructions/cli.instructions.md). Copyright stays with the author.
CLI Review Instructions
The CLI is an agent-facing product surface. Canonical sources, in order:
apps/cli/AGENTS.md (scope pointers + telemetry
rules), apps/cli/SKILLS.md (the agent contract),
and the root AGENTS.md — CLI Contract
(JSON envelope). Review pointers on top of those:
- The command surface is
apply,branding eject,claim,doctor,eject,logs,plan,reset,schemas list,setup,start,status,stop—setupsupports 8 frameworks. The claim lifecycle is shipped (ADR 046); do not request its removal. - Changes to command names, flags, envelope shape, server resolution,
scaffold posture (ADR 042/
043/
044), or agent
guidance must update tests,
SKILLS.md, and the generated README command section together. --server localmust resolve through.zitadel/local/runtime.jsononly when the local runtime is healthy, otherwise return a stableE_LOCAL_SERVER_NOT_RUNNINGenvelope.- Mock behavior should be explicit and must not be presented as live platform behavior.