> ## Documentation Index
> Fetch the complete documentation index at: https://docs.substrate.42.pe/llms.txt
> Use this file to discover all available pages before exploring further.

# substrate pending-approval — List Human Gate Tasks

> substrate pending-approval lists every task blocked on a human_only gate across all boards, with the exact command to approve each one.

Run `substrate pending-approval` to get your cross-board report of everything waiting on you. When an agent hits a `transition_guard` requiring a `human_only` field it cannot set, the task sits blocked until you decide. This command surfaces all of those tasks in one aligned table, grouped by board, with the exact command to unblock each row. Output is colored on a TTY and plain when piped.

## Usage

```shell theme={null}
substrate pending-approval
substrate pending-approval --json
```

## Options

<ParamField path="--json" type="flag">
  Emit the structured aggregate instead of the human-readable table.
</ParamField>

## What Is Included

Only tasks blocked on a human gate appear in the output. Agent-set gates and already-approved tasks are excluded. Each row shows:

* The board name
* The task title and short id
* The blocked move (`from → to`)
* The `awaiting_fields`
* The exact command to unblock:

```shell theme={null}
substrate approve <task_id> <field>
```

A task awaiting several fields gets one row per field.

<Note>
  The CLI, the `list_pending_approvals` MCP tool, and the UI's "pending approval" pill all read the same aggregate, so they never disagree about what is pending.
</Note>

## See Also

* [`substrate approve`](/cli/approve) to clear a pending gate.
* [Agent Workflow](/agents/agent-workflow) for how an agent should report pending approvals.