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

# Overview

> Fast local webhook capture, storage, inspection, and replay from one CLI.

`wsignal` is a lightweight local webhook receiver for development workflows. It runs a local HTTP server, matches requests against named endpoints, persists every matched request as JSONL, and gives you tools to inspect and replay captured traffic.

## What It Does

* Receives webhook requests on localhost.
* Supports multiple named endpoints from one config file.
* Persists matched requests before acknowledging them.
* Rotates log files by size.
* Browses saved events from the terminal.
* Replays captured events to another URL.
* Optionally forwards events to one or more targets after local persistence.

## Core Workflow

1. Create a config with [`wsignal init`](/commands/init) or by writing `wsignal.config.ts` yourself.
2. Start the receiver with [`wsignal dev`](/commands/dev).
3. Send requests to one or more configured endpoints.
4. Review saved events with [`wsignal logs`](/commands/logs) or [`wsignal inspect`](/commands/inspect).
5. Replay a captured request with [`wsignal replay`](/commands/replay).

## Default Behavior

* Default config file: `wsignal.config.ts`
* Alternate config files: `wsignal.config.js`, `wsignal.config.mjs`
* Default port: `8787`
* Default storage directory: `.wsignal`
* Default central log file: `events.jsonl`
* Default rotation policy: `10 MB`, keep `20` rotated files
* Default endpoint method: `POST`
* Default endpoint response: `200 text/plain` with an empty body

## When To Use It

`wsignal` fits local development cases where you want to:

* Receive webhook traffic without exposing a full application route first.
* Capture payloads for debugging and replay.
* Split incoming traffic by endpoint or log file.
* Keep a simple audit trail of webhook activity during development.

## Next Steps

* Start with [Installation](/getting-started/installation).
* Follow the [Quickstart](/getting-started/quickstart).
* Read the [Configuration Overview](/configuration/overview) before setting up multiple endpoints.