> ## 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.

# logs

> Browse saved webhook records from active and rotated JSONL files.

## Synopsis

```bash theme={null}
wsignal logs [--config ./wsignal.config.ts]
wsignal logs [--endpoint github] [--last 20] [--order asc|desc]
wsignal logs [--id evt_20260329_xxxxxx]
wsignal logs [--follow]
wsignal logs [--interactive]
```

## What It Does

`wsignal logs` reads saved records from:

* The configured central log file
* Any endpoint-specific log files
* Rotated files associated with those log files

If no config file is available, it falls back to reading `.wsignal/*.jsonl` from the current working directory.

## Output Modes

### Interactive

By default, `logs` opens the interactive terminal browser when:

* Standard output is a TTY
* `--follow` is not enabled
* `--id` is not set

You can force this mode with `--interactive`.

### Non-Interactive

Outside interactive mode, `logs` prints a table of records.

If `--id` is provided, it prints the full detail view for that one event instead.

## Options

### `--config <path>`

Read records using a specific config file.

### `--endpoint <name>`

Only include records for one endpoint.

### `--id <eventId>`

Show a single saved event in detail.

### `--last <count>`

Limit the number of records returned.

### `--order <asc|desc>`

Sort by `receivedAt`.

Default: `desc`

### `--follow`

Poll for new records and print them as they arrive.

### `--interactive`

Force the interactive browser UI.

## Examples

Open the default log browser:

```bash theme={null}
wsignal logs
```

Show the latest 20 Stripe records:

```bash theme={null}
wsignal logs --endpoint stripe --last 20
```

Show one event in full:

```bash theme={null}
wsignal logs --id evt_20260329_xxxxxx
```

Stream new events as they arrive:

```bash theme={null}
wsignal logs --follow
```