Logs

The logs command group provides access to Suduxu's logging system. Logs can be viewed in real time, filtered by level, searched, or cleared entirely.

Show Logs

Display log entries from the local Suduxu log store.

suduxu logs show

By default, Suduxu displays the most recent 25 log entries.

Follow Logs in Real Time

Monitor logs as they are written.

suduxu logs show --follow

This behaves similarly to tail -f and continuously streams new log entries to the terminal.

Limit Output

suduxu logs show --tail 50

suduxu logs show --head 50

Filter by Log Level

Only display entries matching a specific severity level.

suduxu logs show --level error

Examples:

suduxu logs show --level debug
suduxu logs show --level info
suduxu logs show --level warning
suduxu logs show --level error

Search Logs

Filter log entries by text.

suduxu logs show --grep "connected"

Only log entries containing the specified text will be displayed.

You can combine text filtering with other options:

suduxu logs show --level error --grep "network"

Filter by Time Range

Display logs within a specific time window.

suduxu logs show --since "2026-01-01"

suduxu logs show --until "2026-01-01"

suduxu logs show --since "2026-01-01" --until "2026-01-31"

Combine Filters

All filters can be combined to narrow down results.

suduxu logs show \
  --level error \
  --since "2026-01-01" \
  --grep "client"

This displays only error logs containing the word client after the specified date.

Clear Logs

Delete all stored log entries.

suduxu logs clear

Common Workflows

suduxu logs show --level error

suduxu logs show --follow

suduxu logs show --grep "connected"