Skip to main content
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

​
Options

​
flag
Emit the structured aggregate instead of the human-readable table.

​
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:
A task awaiting several fields gets one row per field.
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.

​
See Also