Skip to content

Workflow properties panel ​

The Workflow Properties panel in the ctrlyoke dashboard edits the root-level fields of the loaded workflow without opening its file. Each tab along the bottom of the panel covers one group of fields: Harness, Context, Validation, MCP, Hooks, and Permissions.

Everything here is the workflow-level value. A step can still override a field from its own properties drawer, and fields you leave unset fall back to the matching defaults.* setting. See How values are inherited for the full order.

  • Set as Default appears next to a field when its value differs from your default. Click it to write the current value to the matching defaults.* setting so new workflows start with it.
  • Reset all to defaults (the circular-arrow button in the panel header) sets every field back to your current defaults.

Harness ​

Harness tab with the harness picker open, listing all six harnesses

The Harness tab chooses what runs each prompt and where it runs:

  • Harness and Model — the AI CLI and model. See Harnesses for what each one supports.
  • Agent and Skills — portable prompt attachments that work the same on every harness. See Agents and skills.
  • Additional Args — extra CLI flags appended to the ones ctrlyoke manages, such as --effort high.
  • Execution Mode — Interactive runs in a live terminal; Headless runs in the background with output in the dashboard.
  • Worktree — run in your working checkout or in a Git worktree.

Worktrees ​

A Managed worktree is a throw-away worktree and branch created for each run. Base picks the Git ref it starts from, and Setup runs once after the worktree is created (for example npm ci). Keep directory leaves the worktree on disk after the run for review and undo, and Merge merges the branch back into your working checkout after every run.

Harness tab with a managed worktree, showing Base, Setup, Keep directory, and Merge

A Named worktree targets a persistent branch you own. Optionally set Directory to keep one long-lived worktree directory; leave it empty to derive the directory from the branch. The field suggests your existing linked worktrees, and you can also type a new name (created as exactly that folder under the worktree root) or a path. When a directory is set, its branch can differ from the directory name and ctrlyoke switches to that branch when the directory is clean. ctrlyoke creates a named worktree if needed but never commits, merges, or removes it, which suits workflows you keep appending to.

Harness tab with a named worktree on the bug-fix branch

Field details: worktree.

Context ​

Context tab with Resume Session, Prior Context set to Previous 2 with Summary detail, and a workflow variable

  • Resume Session — continue an earlier harness session instead of starting fresh. Leave the session field blank to auto-resume, or enter a session ID or a prompt number. See Session management.
  • Prior Context — inject earlier step outputs into each prompt. The detail dropdown below the selector sets priorContextDetail: Full sends each step's complete record, and Summary sends a bounded excerpt (the start of the prompt, the files changed, and the end of the reply). Choosing Previous N shows a count field, and choosing Custom shows a field for specific prompt numbers, such as 1,2,4-10. Choosing Completed run output shows a workflow field and an optional run number field; see Output from another workflow. See also Prior output references.
  • Variables — workflow-level {{name}} values. Use Bulk edit to paste several name=value lines at once.

Validation ​

With nothing enabled, the Validation tab shows the Pre-Condition and End Condition toggles, plus the workflow's Error Behavior and Max Steps.

Validation tab with no pre-condition or end condition enabled

Enable End Condition to run a script after each prompt and decide whether the work passed. Pass when compares the script's exit code or output against an expected value, and On Pass / On Fail decide what happens next.

Validation tab with an npm test end condition that passes when stdout contains "passed", retrying on failure

When On Fail is Retry, the Retry Prompt tells the harness what went wrong. Condition-output references such as $endCondition:stdout insert the script's actual results.

Validation tab retry settings with a retry prompt that references the end condition's output

See End conditions and pre-conditions for every option.

MCP ​

MCP tab: the built-in ctrlyoke server with 11 of 12 tools enabled (Remove step unticked), and the installed playwright server on and expanded

The MCP tab picks which MCP servers are attached to the harness. The built-in ctrlyoke server lets the AI read workflow status and append steps (see Dynamic workflows), and each of its tools can be switched off individually. Installed Servers lists the servers registered with ctrlyoke; Manage MCP Servers opens the MCP manager in Settings to add, edit, or remove them. See MCP servers.

Tool reference: MCP tools.

Hooks ​

Hooks tab with Session Start, Stop, and Error hooks that run node scripts

Hooks run your own commands on harness events such as Session Start, Stop, and Error, alongside the hooks ctrlyoke uses for completion detection. Each hook has a command, an optional timeout, and its own environment variables. Supported events vary by harness; unsupported events are skipped.

Field details: hooks.

Permissions ​

Permissions tab in Custom mode with allowed and denied tool lists

Containment comes first, then approval:

  • Sandbox — terminal write containment, independent of approval. Choose Inherit, On, Off or None; Inherit names the value it resolves to (Off by default). Off turns each harness's sandbox off, and None passes no sandbox flags so the harness's own settings decide. An error appears under the control when the harness can't sandbox. Steps can override the workflow value.
  • Sandbox mode — how strict On is: Workspace write or Read-only. It appears when Sandbox resolves to On, a sandboxed step inherits its value, or the workflow has an authored mode. See Sandboxing.
  • Trusted External Roots — directories outside the workspace this workflow may use. Inherit keeps the roots from your settings. See External file roots.
  • Secrets — secret environment variables this workflow may use.
  • Tool Permission Mode — how much the harness may do without asking. In Custom mode the harness gets the Allowed Tools and Denied Tools lists below it, and a denied tool always wins. How strictly each harness applies them differs; see How each harness applies them.

Not every harness enforces individual tool patterns. See Permissions for the modes, the pattern syntax and what each harness enforces.

Source-available under the ctrlyoke Commercial License.