manage_nodes
Create, update, get, remove, list, search, or batch-process state graph nodes for decisions, artifacts, plans, milestones, and blockers. Returns nodes, edges, or matches.
Instructions
Manage graph nodes in the state graph (actions: create, update, get, remove, list, search, batch_create, batch_update, add_note). Use manage_nodes instead of manage_tasks when operating on general node types (decisions, artifacts, plans, milestones, blockers) rather than runnable task workflow states.
Returns node object, edge connections, batch results, or search matches.
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_nodes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Unique node identifier for get, update, or remove. | |
| ids | No | Array of node IDs for batch_update. | |
| tags | No | Array of searchable tags. | |
| text | No | Text note content for add_note. | |
| type | No | The type classification of the node. | |
| limit | No | Maximum number of items to return (1-1000). | |
| nodes | No | Array of node payloads for batch_create. | |
| query | No | Search term for full-text search. | |
| title | No | Title or label of the node. | |
| action | Yes | The node management action to execute: create, update, get, remove, list, search, batch_create, batch_update, add_note. | |
| offset | No | Number of items to skip for pagination. | |
| status | No | Status of the node (e.g. pending, in_progress, done, blocked, active, accepted, current). | |
| compact | No | Whether to return a lightweight compact summary. | |
| project | No | Target project name or slug. | |
| metadata | No | Arbitrary structured key-value metadata. | |
| algorithm | No | Search algorithm for search action. | |
| attach_to | No | Node ID to attach observation note to via references edge. | |
| git_branch | No | Git branch filter. | |
| session_id | No | Active session identifier for change attribution. | |
| include_edges | No | Whether to include inbound/outbound edges on get. | |
| expected_version | No | Optimistic concurrency version check for update. |