Skip to content
CLI Reference
Serve

Serve

Run the daemon on the D-Bus session bus until it receives SIGINT or SIGTERM.

D-Bus normally starts it on demand through the systemd user unit when the widget loads, so running it by hand is only needed for debugging. Only one instance can own the bus name at a time.

Changes from the widget’s settings page apply at once. After editing the settings file by hand, send SIGHUP to apply it, for example with systemctl –user reload clankerwatch.

Usage 

clankerwatch serve

Examples

Run in the foreground with debug logging. 

clankerwatch serve --log-level debug

Global options

These settings flags are accepted by every command. See Configuration for how they combine with environment variables and the settings file.

FlagShortDefaultTypeDescription
--claude-config-dir""stringClaude Code’s config directory ($CLAUDE_CONFIG_DIR)
--config""stringYAML settings file, default $XDG_CONFIG_HOME/clankerwatch/config.yaml ($CLANKERWATCH_CONFIG)
--idle-interval20m0sdurationpolling interval while Claude Code is idle ($CLANKERWATCH_IDLE_INTERVAL)
--interval5m0sdurationpolling interval while Claude Code is active, at least 2m ($CLANKERWATCH_INTERVAL)
--log-levelinfostringdebug, info, warn, or error ($CLANKERWATCH_LOG_LEVEL)
--modehybridstringdata source: hybrid, or cache-only to never read credentials or use the network ($CLANKERWATCH_MODE)
--notify80,95stringalert thresholds in percent, empty to turn alerts off ($CLANKERWATCH_NOTIFY)
--notify-authtrueboolalert when the Claude Code login needs attention ($CLANKERWATCH_NOTIFY_AUTH)
--state-dir""stringdirectory for the daemon’s state, default $XDG_STATE_HOME/clankerwatch ($CLANKERWATCH_STATE_DIR)