Query locks
lock_queryLists active work-claim locks for the current git repository, with filters for text, scope, status, or agent. Finished locks are excluded by default; request status 'done' or 'all' to include them.
Instructions
Lists agent-locks work-claim locks for the current git repository (shared across all its worktrees). IMPORTANT: when status is omitted, this ONLY returns active locks — done/finished locks are excluded from the default view by design, so you see what is currently being worked on, not a full history. Pass status: "done" or status: "all" to include finished locks. Returns a compact summary per lock: {id, title, status, percentComplete, scope, agent_id, parent_agent_id}. percentComplete is computed from the ratio of checked to total tasks on that lock (a lock with zero tasks reports 100).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "lock_query"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | Free-text, case-insensitive substring search across each lock's title and its Notes section. | |
| scope | No | One or more glob patterns. Only locks whose own scope glob-overlaps at least one of these patterns are returned. Uses the same overlap heuristic as lock_check_conflict (see that tool's description for its limitations). | |
| status | No | Which locks to include. Defaults to "active" (done locks are excluded unless you explicitly ask for them). | |
| agent_id | No | Only return locks created with this exact agent_id. |