get_story_worktree
Retrieve a story's worktree status by plan name and story key, including branch, HEAD, commits ahead, uncommitted paths, and masked scratchpad details to assess agent progress.
Instructions
Return the story's worktree status: branch, head, commits ahead of the default branch (max 10), uncommitted paths (max 200) and the agent's scratchpad with secret values masked (max 20000 characters).
plan_name: the plan's name this story belongs to. story_key: the story's key within that plan's manifest.
The worktree is resolved from the story record and contain-checked under the worktrees root; there is no path argument. A story with no worktree returns {"available": False, "reason": "no_worktree"}, a git failure {"available": False, "reason": "git_failed"}. An unknown plan/story returns {"ok": False, "status": 404, "error": ...}.
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": {
"plan_name": "<plan_name>",
"story_key": "<story_key>"
},
"name": "get_story_worktree"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| plan_name | Yes | ||
| story_key | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||