Synopsis
Description
daemon registers profClaw as an OS-level service so it starts automatically on boot and restarts on failure. On macOS it creates a launchd plist at ~/Library/LaunchAgents/com.profclaw.agent.plist. On Linux it creates a systemd user unit at ~/.config/systemd/user/profclaw.service.
Logs are written to ~/.profclaw/daemon.log and ~/.profclaw/daemon-error.log on macOS, and to the system journal on Linux.
Subcommands
| Subcommand | Description |
|---|---|
install | Register the service with launchd / systemd |
uninstall | Remove the service registration |
start | Start the service |
stop | Stop the service |
restart | Restart the service (also rotates logs) |
status | Show current service status, PID, and log sizes |
logs | Tail service logs |
rotate | Rotate log files when > 10 MB (macOS only) |
Examples
daemon logs Flags
Follow log output in real time. Press
Ctrl+C to stop.Number of lines to show. Maps to
tail -n on macOS and journalctl -n on Linux.Show the error log only (
daemon-error.log on macOS, journal priority err on Linux).Crash Loop Protection
The service is configured with restart limits to prevent runaway crash loops:| Platform | Behavior |
|---|---|
| macOS (launchd) | ThrottleInterval=10s between restart attempts |
| Linux (systemd) | Max 5 restart attempts per 60 seconds (RestartSec=5s) |
profclaw doctor to identify the root cause, then manually start the service again.
Log Rotation
On macOS, log files rotate automatically when they exceed 10 MB (one.1 backup kept). On Linux, journald handles rotation automatically.
Related
profclaw serve- Start the server in foreground modeprofclaw status- Quick system statusprofclaw logs- View server logs via the APIprofclaw doctor- Diagnose issues