Documentation

Config Reference

The public configuration contract used for work inputs and execution settings. Use work_inputs today; the legacy repos array remains an alias.

Top-level fields

Field	Type	Description
`work_inputs`	`object[]`	Work sources. Currently only GitHub repositories are supported. Each entry accepts the same fields as repos[] and optional type: "github". Use either work_inputs or legacy repos, never both (even if one is empty or null).Example: `[{"type":"github","github_url":"https://github.com/your-org/your-repo"}]`
`attribution_url`	`string`	URL used to attribute automated work in issue comments.Example: `https://github.com/your-org/thaumaton`
`pre_pr_protocol_url`	`string`	URL of a documented pre-PR protocol that the agent should reference before opening a pull request.Example: `https://github.com/your-org/thaumaton/blob/main/docs/pre-pr-protocol.md`

The same public config fields are accepted under either root key, with repos as the legacy alias.

Field	Type	Description
`github_url`	`string`	GitHub repository URL for a work input. The current supported provider is GitHub.Example: `https://github.com/your-org/your-repo`
`type`	`string`	Optional work-input type. Currently only "github" is accepted. The type is optional and defaults to GitHub.Default: `github`Example: `github`
`workspace_roots`	`string[]`	Additional directories the agent may access in the workspace, if configured.
`steps`	`object[]`	Optional ordered pipeline. Omit to use the default six-step flow. Explicit arrays must be nonempty.Example: `[{"name":"resume"},{"name":"idea","prompt":{"mode":"append","text":"Keep changes focused."}}]`
`permissions`	`object`	Repository permissions that grant shell, write, and GitHub MCP access to the agent.
`model`	`string`	Model selection used by the configured execution provider for a repository.Example: `auto`

Field	Type	Description
`repos and work_inputs are mutually exclusive`	`rule`	Only use one root key. The legacy repos array is a compatibility alias of work_inputs.
`github_url`	`rule`	Values must identify a GitHub repo and cannot be null or blank. Duplicate identities are rejected case-insensitively.
`steps[]`	`rule`	Names must be unique, nonempty, and use the supported built-ins. Unsupported providers, selector DAGs, and arbitrary custom step names remain future work.