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

# Local servers

> Run Handler's local webhook server for development, demos, and integration testing.

# Run the local webhook server

Handler ships with a local webhook receiver for task push notifications, which
is useful for development work and integration testing.

## Run the push notification receiver

Start the local webhook receiver on the default port:

```bash theme={null}
handler server run push
```

```bash theme={null}
handler server run push --port 9001
```

By default it binds to `127.0.0.1:9000` and exposes these endpoints:

* `POST /webhook` receives task notifications
* `GET /webhook` returns a simple validation response
* `GET /notifications` lists received notifications
* `POST /notifications/clear` clears stored notifications

## End-to-end push notification test

1. Start the webhook receiver with `handler server run push`.
2. Start or connect to an agent.
3. Send a message that creates a long-running task.
4. Point that task at `http://127.0.0.1:9000/webhook` with `handler task notification set`.
5. Inspect received events at `http://127.0.0.1:9000/notifications`.

This is a simple way to verify that an agent's push flow works before wiring it
into a real webhook consumer.