manage_tasks
Prioritize runnable tasks, complete work, find blockers or stale tasks, and prune outdated items in branch-aware workflow state memory.
Instructions
Task prioritization, workflow execution, blockers, and stale task management (actions: next, complete, find_blocked, find_stale, find_blockers, find_similar_blockers, auto_prune). Use manage_tasks instead of query_graph when querying runnable tasks by priority order or resolving execution blockers.
Returns prioritized runnable tasks, blocker hierarchy, similar resolved blockers, or completion confirmation.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "manage_tasks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Node type filter for find_stale. | |
| limit | No | Maximum tasks to return (1-1000). | |
| query | No | Query text for find_similar_blockers. | |
| action | Yes | The task management action to execute: next, complete, find_blocked, find_stale, find_blockers, find_similar_blockers, auto_prune. | |
| status | No | Status filter for find_stale. | |
| node_id | No | Optional node ID to check blockers for. | |
| project | No | Target project name or slug. | |
| task_id | No | Task node ID to complete. | |
| threshold | No | Similarity threshold for find_similar_blockers (0.0 - 1.0). | |
| git_branch | No | Git branch filter. | |
| older_than | No | Duration threshold for staleness (e.g. 7d, 24h, 30m). | |
| decision_id | No | Decision node ID for find_blocked. | |
| target_status | No | Target status to assign when auto-pruning (e.g. cancelled). | |
| artifact_title | No | Optional title of artifact produced on complete. | |
| include_context | No | Whether to include parent plan/milestone and blocker context on next. | |
| visual_state_id | No | Optional visual state ID to link on complete. | |
| artifact_metadata | No | Optional metadata for produced artifact. | |
| artifact_file_path | No | Optional file path for produced artifact. | |
| include_transitive | No | Whether to include transitive blockers. | |
| visual_relationship | No | Visual relationship for complete (default: renders_state). |