CLI
circuit create
Create a custom flow.
Experimental. CLI only.
circuit create --description '<flow idea>' [options]Create a new custom flow, validate it, and optionally publish it. Create reads your description and picks a flow shape that fits the task, then writes a draft alongside a custom-flow descriptor. --publish --yes promotes the draft into a runnable flow, skill, and slash command.
Flags
| Flag | Description | Default |
|---|---|---|
--description <flow idea> | What the flow is for. Required. | |
--name <slug> | Lowercase kebab-case name. Derived from the description if omitted. Reserved names are rejected. | |
--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. | |
--decompose | When the task lands on the build shape, generate the full step-by-step spine instead of the thin default. | (off) |
--progress <jsonl> | Stream progress events as JSONL. |
Examples
Draft a flow:
circuit create --description 'tighten flaky integration tests'Name it explicitly:
circuit create --name flake-hunter --description 'tighten flaky integration tests'Publish in one step:
circuit create --description 'tighten flaky integration tests' --publish --yesRun a published custom flow:
circuit run flake-hunter --flow-root ~/.config/circuit/custom/flows --goal '<task>'