logs

Browse saved webhook records from active and rotated JSONL files.

Synopsis

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:

wsignal logs

Show the latest 20 Stripe records:

wsignal logs --endpoint stripe --last 20

Show one event in full:

wsignal logs --id evt_20260329_xxxxxx

Stream new events as they arrive:

wsignal logs --follow