Create task
create_taskCreate a new Kanban task with a required title plus optional description, links, tags, priority, status, and metadata; use dryRun to validate before writing.
Instructions
Create a new task with title, description, and metadata. Pass fields (e.g. ["id","title","status"]) for a compact answer instead of the full task object; pass dryRun to validate without writing anything. LINKS merge: links ADDS every listed taskId+type pair to the new task and parent (when given) is folded into the same union, so sending both merges once and a pair named twice is a no-op — the same MERGE semantic update_task has, where a link you do not name is simply absent (a new task has nothing to preserve). links: [] is REFUSED — omit the field for no links. Use it for a new unit of work; use update_task to change an existing task, and add_comment to discuss one without editing it.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | URL the annotation targets. Together with selector this makes the task annotated (overlay-verifiable); omit both for a plain task. | |
| tags | No | Tags for filtering (list_tasks --tag matches every listed tag). Omit for untagged. | |
| type | No | Task type. Defaults to Task; use Research for an investigation (it reaches review on its attached .md report, with no verification verdict). | Task |
| links | No | ADD the listed links to the new task (merge, same as update_task's `links`). Combined with `parent` as a union; a pair named twice is a no-op. `links: []` is REFUSED — omit the field for no links. | |
| title | Yes | Task title — the only required field. | |
| dryRun | No | Preview only: validate the input and report what WOULD be created without writing a task file. | |
| fields | No | Return only these task fields (e.g. ["id","title","status"]) instead of the full task object. Omit for the full object — same selector list_tasks and get_task take. | |
| parent | No | Parent task id (full id or unique prefix) to create this task as a child. Omit for a root task; merges with links as one union when both are given. | |
| status | No | Initial status. Defaults to todo; pass another status only to create the task already in motion. | todo |
| sortKey | No | Explicit board ordering key. Omit it — core auto-assigns one — unless you must place the task exactly. | |
| priority | No | Priority tier, driving claim order (Critical first). Defaults to Medium. | Medium |
| selector | No | CSS selector of the annotated element (default "/", meaning the whole page). Only meaningful with url. | / |
| cssSelector | No | Alias of selector for clients that prefer the explicit name; both write the same field. | |
| description | No | Longer task body (what to do, acceptance criteria). Optional; omit when the title says it all. |