twocents/open source

CLI and schema reference

Commands, JSON schemas, and exit codes.

This reference is generated from reviewed snapshots of the CLI commands and schemas. CLI schema version: 8. Envelope protocol version: 1. To inspect your installed version, run:

guildscribe help
guildscribe recordings --help
guildscribe doctor --schema init.request
guildscribe doctor --schema config.update.request

Automation behavior

Finite commands write one compact JSON envelope to stdout with protocolVersion, requestID, command context, and ok. Success data is under result; failures provide error.code, message, details, and retrySafety. Diagnostics go to stderr. Check both exit status and ok. The daemon is long-running.

Use --request-id to supply a caller ID; one is generated otherwise. Duration flags require units such as --timeout 30s. Structured input and secrets use request files or stdin. --no-input and --non-interactive disable prompts but do not grant confirmation. The generated options show available previews.

ExitClass
0Success
1Internal failure
2Invalid input
3Configuration
4Unsupported
5External dependency
6Timeout
7Resource error
8Confirmation required

Retry safety is safe, unsafe, or never. Set a retry limit for safe failures. Never repeatedly issue unsafe mutations automatically: an effect may already have happened even when a timeout or transport failure is reported. Inspect state first. never requires changed input or state.

Commands

Generated from the reviewed command catalog. Global options:

  • -V, --version
  • --home <absolute-path>
  • --request-id <ID>
  • --timeout <duration>
  • --no-input
  • --non-interactive
  • --quiet
  • --verbose
  • --verbosity <level>

JSON schemas

Contract schema version 8. This page is rendered directly from contracts/guildscribe/schemas.json.

On this page