Docs CLI

Commands

The small surface of the gridtrue CLI, verb by verb.

The CLI aims for a Unix-small surface area. The verbs below cover the day-to-day. Run gridtrue --help or gridtrue <verb> --help for the authoritative spec.

Command	What it does
gridtrue login	Authenticates you, enrolls a cert from your org, stores it in the OS keyring.
gridtrue logout	Revokes the local enrollment and wipes the keyring entry.
gridtrue org create <slug>	Provisions a new org on the Free tier. Unlimited seats, no credit card.
gridtrue org invite <email>	Emails a teammate a one-time enrollment link scoped to the current org.
gridtrue repo create <name>	Creates a new repo in the active org. Accepts --policy to copy an existing policy contract.
gridtrue validate	Runs the manifest in .gridtrue/validate.yaml. Emits a signed attestation on success.
gridtrue attest --last	Re-broadcasts the attestation for the last validate (useful after a network blip).
gridtrue status	Shows the current commit's state (DRAFT / VALIDATING / ATTESTED / PROMOTABLE / DEPLOYED).
gridtrue radar watch	Streams Conflict Radar events for the current repo. Exits cleanly on Ctrl-C.
gridtrue sdk install <name>	Installs a pinned toolchain into ~/.gridtrue/sdk (Go, Node, Python, Java, Rust).
gridtrue hooks install	Wires pre-commit and pre-push hooks into the current repo's .git/hooks.
gridtrue daemon {start,stop,status}	Controls the background daemon that powers Conflict Radar and the browser bridge.
gridtrue export --org <slug>	Exports the full ledger + bytes + identity materials for an org. Works on every tier.

Exit codes

0: Success.
1: Validation failed (one or more predicates returned non-zero).
2: Usage error — bad flag, missing argument, malformed manifest.
3: Policy rejected the attestation — the network refused the push or required proofs were missing.
4: Identity error — not logged in, cert expired, keyring unavailable.
5: Network error — could not reach the org network. Re-run with --offline to validate only.