# polymorfa listen

> Listen for project events and optionally forward their exact payloads.

## polymorfa listen

Listen for project events and optionally forward their exact payloads.

### Usage

```bash
polymorfa listen [flags]
```

### Flags

- `--allow-remote-forward` (boolean). Allow validated public HTTPS forwarding destinations.
- `--checkpoint-file <value>` (value). Resume from and atomically update a private checkpoint.
- `--event <value>` (value, repeatable). Listen for an event type or trailing-wildcard pattern. Default: `*`.
- `--follow-redirects` (boolean). Follow at most three validated 307 or 308 redirects.
- `--forward-secret-out <value>` (value). Write the one-time local forwarding secret to a new mode-0600 file.
- `--forward-to <value>` (value, repeatable). Forward exact event payloads to this destination.
- `--from <value>` (value). Resume after this opaque listener cursor.
- `-H, --header <value>` (value, repeatable). Add a custom header to forwarded requests (Name: value).
- `--max-buffer <value>` (value). Bound locally pending events. Default: `256`.
- `--on-gap <value>` (value). Stop safely or continue explicitly after a cursor gap. Values: `stop`, `continue`. Default: `stop`.
- `--project <value>` (value). Use a project UUID; team API keys may use a unique slug. Defaults to the linked or profile project.
- `--skip-verify` (boolean). Accept a self-signed HTTPS certificate from a loopback forwarding destination.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).
