project_tasks
Create, list, update, and delete tasks in a per-project queue. Supports subtasks, status, priority, labels, and blocking dependencies.
Instructions
Manage a persistent per-project task queue. Tasks and analyzer configs survive sync_index reset; reset clears function index, cached audits, code maps, and schema overlays (no ghost code references). Use delete to remove a task.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Delete mode: reject (default), detach subtasks, or cascade descendants. | |
| dueAt | No | ISO 8601 due datetime for create; omit or null in patch to clear. | |
| label | No | Filter/search by label value. | |
| limit | No | Max tasks to return for list (default 500, max 1000). | |
| patch | No | For update: partial fields (title, description, status, priority, labels, metadata, parentTaskId, source, blockedBy, dueAt, sortOrder, relatedFiles, relatedSymbols). | |
| query | No | Case-insensitive text search across title/description/labels/files/symbols. | |
| title | No | Task title. Required for create. | |
| action | Yes | list | list_tree | create | get | update | complete_task | delete. list/list_tree/create use projectPath or default to process.cwd(); create needs title; get/update/complete_task/delete need taskId; update needs patch object. | |
| labels | No | String tags (e.g. ["audit","refactor"]). | |
| source | No | manual | audit | mcp. Filter for list; provenance for create; can be set via update patch. | |
| status | No | pending | in_progress | blocked | done | cancelled. Filter for list; initial status for create; can be set via update patch. | |
| taskId | No | Stable task id (UUID). Required for get, update, complete_task, delete. | |
| metadata | No | Arbitrary JSON object: related file paths, links, audit IDs, etc. | |
| priority | No | Optional priority for create/update patch. | |
| blockedBy | No | Task IDs this item is blocked by (waiting-on). | |
| sortOrder | No | Lower numbers sort first within a project (default 0). | |
| description | No | Longer description / notes. | |
| hasChildren | No | Filter tasks that do/do not have direct subtasks. | |
| overdueOnly | No | Filter tasks with dueAt in the past and not closed. | |
| projectPath | No | Project root (resolved). Omit to use the MCP server working directory (same default idea as audit path); response includes projectPathDefaulted when omitted. | |
| parentTaskId | No | Optional parent task for subtasks. | |
| relatedFiles | No | Repo-relative or absolute file paths tied to the task. | |
| actionableOnly | No | Filter tasks that are open and unblocked by open dependencies. | |
| relatedSymbols | No | Function, class, or component names for cross-linking. | |
| blockedByTaskId | No | Filter tasks blocked by this task ID. |