| name | worktree-cleanup |
| description | Mark a worktree merged and clean it up (kind-aware) via LocalApiServer — requires the Switchboard extension running (no direct-DB fallback). |
| allowed-tools | Bash |
| disable-model-invocation | true |
Worktree Cleanup
When to Use
- ONLY after a merge the agent performed at the user's request, and ONLY when the user has confirmed they want the worktree cleaned up.
Prerequisites
VS Code setting switchboard.apiToken must be configured with your API token.
Usage
CUR="$PWD"
while [ "$CUR" != "/" ] && [ ! -d "$CUR/.agents/skills" ]; do CUR=$(dirname "$CUR"); done
source "$CUR/.agents/skills/_lib/sb_api_call.sh"
sb_api_call POST /worktree/cleanup \
-H "Content-Type: application/json" \
-d '{ "worktreeId": "<id-or-branch>", "workspaceRoot": "/abs/path/to/workspace" }'
Parameters
- worktreeId (required): The worktree database ID (integer) or git branch name (string).
- workspaceRoot (optional): Absolute path to the workspace root.
Response
{
"success": true
}
Error Handling
- 401 Unauthorized: Token not configured.
- 400 Bad Request: Missing worktreeId.
- 502/500: Database or filesystem worktree cleanup failure.
