CLI
circuit generate
Have a model author a custom flow from a task description.
Experimental. CLI only.
circuit generate --description '<task>' [options]Generate asks a model to author a new custom flow for the task you describe. Where create picks from known flow shapes without calling a model, generate writes the flow itself, validates the result against the same schema and safety floor as the built-in flows, and repairs it when validation fails. It spends model time.
Flags
| Flag | Description | Default |
|---|---|---|
--description <task> | What the flow is for. Required. | |
--name <slug> | Lowercase kebab-case name. Derived from the description if omitted. | |
--home <path> | Where drafts and published flows live. | ~/.config/circuit/custom |
--created-at <iso> | Publish timestamp. | current time |
--publish | Publish immediately. Requires --yes. | |
--yes | Confirm publication. | |
--max-repair <n> | How many repair passes to attempt when validation fails. | 4 |
--timeout-ms <ms> | Timeout for each model call, in milliseconds. | 90000 |
--progress <jsonl> | Stream progress events as JSONL. |
Examples
Draft a flow:
circuit generate --description 'migrate a REST endpoint to GraphQL with contract tests'Publish in one step:
circuit generate --description 'migrate a REST endpoint to GraphQL with contract tests' --publish --yesRun a published custom flow:
circuit run <name> --flow-root ~/.config/circuit/custom/flows --goal '<task>'