pan-unpause git:20261104.d7a9fc8A

Immutable. This exact content never changes and is served at /api/v1/blob/4982e32af599c6a0.

---
name: pan-unpause
description: "pan unpause <id> — clear an agent pause gate without spawning it"
triggers:
  - pan unpause
  - unpause agent
  - resume auto resume
  - clear pause gate
allowed-tools:
  - Bash
  - Read
---

# pan unpause

Run the command now:

```bash
pan unpause <issue-id>
```

## Usage

```bash
pan unpause PAN-123
```

`<id>` also accepts a full agent ID, a conversation name such as `20260928-7563`, `conv/<n>` or `conv:<n>`, and a dashboard URL such as `https://overdeck.localhost/conv/2972`.

## What It Does

`pan unpause <id>` clears the persistent pause fields from the agent state file, then resumes the agent's saved session when it has one. Without a saved session it prints `pan start <id>` for the operator to run.

When the pause was an issue pause that stopped the issue's reviewers, unpause first re-requests the review through the normal review door (the same one `pan review request` uses), which starts a fresh review convoy for the current head. A merged issue or an already-approved head is reported as "No review re-requested", not as a request. When it stopped only the test agent, unpause re-dispatches the test role. If the re-request fails (dashboard down, dirty tree, re-review limit), unpause exits 1 and tells you to run `pan review request <id>`; the Deacon also re-requests the halted review on a later patrol.

## When to Use

- Use `pan unpause` after the reason for a manual pause has been resolved.
- Use `pan start <id> --force` instead only when you intentionally want to clear the pause gate and spawn in one step.

## See Also

- `pan pause <id>` — set the persistent pause gate
- `pan start <id>` — spawn after the gate is clear