| name | bwoc-list |
| description | List BWOC agents registered in the workspace. Wraps `bwoc list`. Use to discover which agents exist, their backend, status, and pending inbox counts. |
bwoc-list
List the agents registered in the enclosing BWOC workspace's agents.toml.
This is a read-only wrapper over the bwoc CLI. Run:
bwoc list
Options (pass through verbatim)
--json — emit machine-readable JSON instead of the table.
--status <STATUS> — filter by status (active, stopped, retired).
--backend <BACKEND> — filter by backend (claude, antigravity, codex, kimi, copilot, ollama, openai-compatible).
--running — only agents whose daemon is actually running.
--inbox-pending — only agents with at least one pending inbox envelope.
--sort <id|inbox|incarnated|backend> — sort key.
--count — print just the integer count of matching agents.
--names-only — bare agent ids, one per line (handy for for name in $(...) loops).
--workspace <PATH> — override workspace root (default: BWOC_WORKSPACE env > ancestor walk > cwd).
--lang <en|th> — output language.
Examples
bwoc list
bwoc list --json
bwoc list --status active --names-only
bwoc list --backend codex
bwoc list --inbox-pending --count
Surface the result back to the user. Do not add business logic — this is a thin wrapper.