> ## Documentation Index
> Fetch the complete documentation index at: https://beads.gascity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# bd reclaim

> Revert stale-lease in_progress issues back to ready (dead-worker recovery)

Generated from `bd help --doc reclaim`.

Revert in\_progress issues whose lease has gone stale back to ready.

When a worker claims an issue it takes a lease that expires after a TTL, kept
alive by 'bd heartbeat'. A worker that dies stops heartbeating, so its lease
expires and its issue would otherwise stay in\_progress forever. reclaim is the
reaper: it finds in\_progress issues whose lease expired more than --older-than
ago, clears the assignee, and sets them back to open so another worker can
claim them. The previous owner's stale lease is recorded as a recovery event.

\--older-than is a grace window past lease expiry: only leases that expired at
least this long ago are reclaimed, so a worker briefly paused (GC, clock skew)
is not robbed of live work. Run it from a supervisor on a timer with a window
of roughly 2× the claim TTL.

Examples:
bd reclaim                       # default grace window (2× the lease TTL)
bd reclaim --older-than 10m      # reclaim leases expired >10m ago
bd reclaim --older-than 0s       # reclaim every currently-expired lease

```
bd reclaim [flags]
```

**Flags:**

```
      --older-than duration   Only reclaim leases that expired at least this long ago (grace window) (default 10m0s)
```