<!-- zibby-template-version: 4 -->
# /zibby-list — list agents (local + cloud) with their UUIDs and statuses

You are helping the user see what agents exist — locally scaffolded and remotely deployed.

Canonical docs: **https://docs.zibby.app/cli-reference#workflow-list**

## Steps

1. **Run the list command:**
   ```
   Bash(zibby agent list)
   ```
   This shows both local (in `.zibby/workflows/`) and remote (deployed to Zibby Cloud) agents. Each row has: name, UUID, project, last triggered.

2. **Filter on demand.** If the user wants only local or only remote:
   ```
   zibby agent list --local-only
   zibby agent list --remote-only --project <id>
   ```

## When you'd use this

- User asks "what agents do I have?" → run it, show the result.
- You need a UUID to pass into `/zibby-trigger`, `/zibby-tail`, `/zibby-delete` and the user only knows the name → run it, look up the UUID.
- After a deploy to confirm the bundle landed.

## Output expectations

The output is human-readable text (not JSON). If you need to extract a specific UUID programmatically, parse the line for the agent name. If the user has many agents, ask which one they want — don't grep blind.
