---
title: "See which coding agent is waiting on you"
url: "https://docs.phux.sh/agent-waiting"
source: "https://github.com/no-phux/website/blob/bffc0f5a462084993a7cfe1367f97d7ac533cf9f/src/site-docs/agent-waiting.md"
projectVersion: "0.113.1"
protocolVersion: "1.0.0"
stability: "stable"
---
# See which coding agent is waiting on you
phux agent list prints each coding agent's state, and blocked means it is waiting on you. phux agent wait --any --until blocked returns when the next one starts waiting.
```sh
phux agent list
phux agent wait --any --until blocked --timeout 600
```
`phux agent list` prints one line per pane: the agent's kind, its address, and its state. `--json` prints the same facts as a document. The states are `working`, `blocked`, `idle`, `done`, and `unknown`. What each state means, and the order of evidence phux uses, is the table on [Coding agents](/agents#agent-states).
`blocked` is a permission prompt or a question. Screen rules ship for Claude Code, Codex, OpenCode, Aider, and the other programs named on that page. A screen that matches no rule reads as `idle`, never `blocked`.
`phux agent wait` returns when an agent moves into the state you name. It does not succeed because the agent is already in that state. An agent that is already `blocked` when the wait starts times out with exit 124. Read the current state with `phux agent list` or `phux agent show @7`.
`--any` waits for the first matching transition from any local agent. Omit it and pass one pane (`%reviewer` or `@7`) to wait on that pane. `--until` defaults to `idle`, `blocked`, and `done` together. Pass `--until blocked` to wait only for an agent that needs you, or repeat the flag to name more than one state. With no `--timeout` the wait runs until a transition. Pass a timeout in a script. `--json` prints a document instead of a line.
In the terminal UI, C-a q jumps to the next pane whose agent is waiting. C-a Q jumps back.
On another machine, SSH in and run the same commands there, or attach after you add the machine. [Remote machines](/remote).
## Next
- [Coding agents](/agents)
- [Run a command in a pane](/pane-command)