Skip to content

Automations and goals ​

For the concept and everyday use, read Automations & Goals.

Fields ​

FieldDescriptionDefault
Automations.EnabledEnables the Automations orchestratortrue
Automations.PollingIntervalPolling interval00:00:10
Automations.MaxConcurrentTasksMaximum concurrent local tasks3
Automations.TurnTimeoutSingle-turn timeout00:30:00
Automations.WorktreeRetentionEnabledEnables retention cleanup for idle automation task worktreestrue
Automations.WorktreeRetentionIdlePeriodIdle period before a clean automation task worktree is eligible for cleanup21.00:00:00
Goals.EnabledEnables goal storage, AppServer methods, goal context injection, usage accounting, and model goal toolstrue
Goals.AutoContinueEnabledAllows active goals to continue when a Thread is idletrue

Automations.WorktreeRetentionIdlePeriod must be at least 14.00:00:00. The retention sweep only removes managed automation task worktrees that are idle, clean, and have no commits ahead of their base.

Automation AppServer methods:

MethodDescription
automation/listList definitions
automation/readRead a definition
automation/createCreate an automation
automation/updateSave with expectedVersion
automation/runQueue one run
automation/deleteDelete a definition
automation/runs/listRead run history
automation/presets/listList conversational presets

Goal AppServer methods:

MethodDescription
thread/goal/setSet, replace, pause, or resume a Thread goal
thread/goal/getRead current Thread goal state
thread/goal/clearClear current Thread goal