run
Destructive
Execute pending tasks from an existing devplan. Preview changes with dry_run or run a single task by task_id.
Instructions
Execute a project's ALREADY-PLANNED pending tasks (a devplan).
Use when: tasks already exist (from a prior ``plan`` or a devplan directory)
and you want to execute them. Do NOT use when: no plan exists and you are
starting from a goal — that is ``build``'s job (it analyzes and decomposes).
Related: ``build`` (plan + execute a goal), ``status`` (see the task ids).
Pass ``task_id`` to run a single task.
DESTRUCTIVE side effects: edits files and makes git commits, and calls an
external LLM provider (open-world, non-idempotent). ``dry_run=True`` previews
without changing anything.
Returns a short text summary of what was run or previewed.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Absolute path to a registered project's directory that already has planned tasks (a devplan). Example: '/Users/me/code/my-api'. | |
| dry_run | No | When true, preview the tasks that would run without executing or editing anything. Example: true. | |
| task_id | No | Run only this single task id (as shown by ``status``); omit to run all pending tasks in dependency order. Example: '010-add-auth'. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |