For agents

Every command returns one JSON document with a schema field such as gozo.doctor/v1 or gozo.test/v1. Errors are JSON as well, with schema: "gozo.error/v1". Fields never change inside a schema version; a breaking change bumps the version.

gozo doctor --json | jq '.findings[] | select(.status == "fail")'
gozo test --json | jq '.summary'
gozo deploy --prod --json | jq -r '.deployment.url'

gozo apiCopy Anchor Link

A read-only view of project state for scripts and agents.

gozo api ls          # every resource
gozo api project     # name, root, modules, Go version, link target
gozo api config      # gozo.toml as parsed, defaults filled in
gozo api env         # variables per environment, values masked
gozo api deployments # local deployment history
gozo api doctor      # same document as gozo doctor --json

Non-interactive modeCopy Anchor Link

When stdin is not a terminal, or CI, CLAUDECODE, CURSOR_AGENT or AGENT is set, gozo never prompts. A prompt that would block returns an error telling you which flag to pass instead, usually --yes.