# strata19.workspace_inventory
URL: /documentation/reference/tools/workspace_inventory



{/* GENERATED FILE — do not edit. Sources: src/mcp/facade/tool-projection-registry.ts (availability) + describe() in src/mcp/facade/facade-tools.ts (prose). Regenerate: pnpm exec tsx scripts/docs/site/generate-tool-reference.ts */}

## What it does [#what-it-does]

A read-only census of every git worktree of every project Strata19 knows about: branch, whether it is merged, dirty and untracked file counts, local work items, sessions, running listeners, and the unique state that removing it would lose. `reclaimable` is "blocked" whenever any of that is non-zero, never inferred from size. Sizes are only measured when `measureSizes` is true. Machine-wide: it ignores the bound project.

## When to use it [#when-to-use-it]

**Use when:** "which worktrees do I have" · "is this worktree safe to remove" · "what is using disk" · "what unmerged work is sitting in other worktrees"

**Also use when:** before suggesting a worktree or branch cleanup, to check nothing unique would be lost

## When not to use it [#when-not-to-use-it]

you want to delete, prune or move a worktree — this tool only reads and never changes git or any state database

## Availability [#availability]

|           |                                       |
| --------- | ------------------------------------- |
| Tier      | Expert                                |
| Lifecycle | Live                                  |
| Taught by | `strata19-coordinate-multi-repo-work` |