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

# events

> CLI reference: list the agent events floo recorded for an app

List the agent events floo recorded for an app. floo raises an event when a
deploy fails or a runtime error repeats past its threshold, then POSTs it to
your configured webhook. See [Agent Webhooks](/docs/guides/agent-webhooks) for the
event shape and lifecycle.

```bash theme={null}
floo events list --app my-app
floo events list --app my-app --status resolved --json
```

| Flag              | Description                                                           |
| ----------------- | --------------------------------------------------------------------- |
| `--app APP`       | App name or UUID, inferred from config when omitted                   |
| `--status STATUS` | Filter by event status, such as `triggered`, `resolved`, or `skipped` |
| `--json`          | Machine-readable response for agents                                  |

This is a read surface. It does not trigger recovery or modify an event.