Skip to main content

​
Synopsis

profclaw logs [flags]

​
Description

logs fetches structured log entries from the running profClaw server. Logs can be filtered by level, component, and recency. In follow mode (--follow), it connects to the server’s SSE log stream and prints new entries as they arrive.

​
Flags

​
--level
string
Filter by log level. One of debug, info, warn, error. Shows only entries at or above the specified level.
​
--component
string
Filter by component name (e.g., queue, executor, chat, cron).
​
--since
string
default:"1h"
Show logs from this time window. Format: 30m, 2h, 1d. Defaults to the last hour.
​
-l, --limit
string
default:"50"
Maximum number of log entries to return (non-follow mode).
​
-f, --follow
boolean
Stream new log entries as they arrive via Server-Sent Events. Press Ctrl+C to stop.
​
--json
boolean
Output as JSON. In follow mode each event is printed as a JSON line.

​
Examples

profclaw logs

​
Log Levels

LevelColorDescription
debugdimVerbose internal state, used for development
infoblueNormal operational events
warnyellowNon-fatal issues that need attention
errorredErrors that affect functionality

​
Daemon Logs

When running profClaw as a daemon, logs go to the system journal (Linux) or flat files (macOS). Use these commands to access them: 
# macOS daemon logs
profclaw daemon logs --follow
profclaw daemon logs --errors

# Linux daemon logs
journalctl --user -u profclaw -f