# delete\_worktrees

Queue worktrees for deletion in the background, each as its fate says.

writes · idempotent · destructive · CLI only · [Worktree](https://komrad.dev/latest/api/worktree.md)

Komrad skips any worktree with a live agent.

## Calling it

```bash
curl -X POST http://127.0.0.1:8787/komrad.worktree.v1.WorktreeService/DeleteWorktrees \
  -H 'Content-Type: application/json' \
  -d '{
  "dirs": [
    "<dirs>"
  ]
}'
```

```bash
komrad rpc delete-worktrees \
  --dirs '<string>'
```

## Request

### DeleteWorktreesRequest

| Field | Type | Description |
| --- | --- | --- |
| [`dirs`](https://komrad.dev/latest/api/worktree/delete-worktrees.md#komrad-worktree-v1-DeleteWorktreesRequest-dirs) | string\[\]\* no repeats each not empty | The worktrees to delete, by the paths [`list_worktrees`](https://komrad.dev/latest/api/worktree/list-worktrees.md) returns. |

## Response

### Empty

No fields.
