CLI reference: Monitor

8 commands. Every command runs on your own computer; nothing is sent to a social network unless a publishing command is run by the owner with its live switches.

reachweaver statusline

One short read-only line for Claude Code’s status line (version, drafts, queued, needs review, ideas, PAUSED); never creates a database, reads no stdin, no network

reachweaver statusline [-h]

No options.

reachweaver queue-health

Offline status, attempts, overdue and uncertain sends, provider cooldowns; never auto-retry

reachweaver queue-health [-h] [--stale-minutes STALE_MINUTES]

Option	Description
--stale-minutes STALE_MINUTES	Mark sending claims older than this threshold as stale (5..10080)

reachweaver dead-letter

Read-only needs_review posts grouped by sanitized error code + reconcile steps; never retries

reachweaver dead-letter [-h] [--json]

Option	Description
--json	Machine-readable grouping

reachweaver ops-metrics

Read-only operational counts (claims, failures by send class, cooldowns, pause, dead letters, stale sending, due age) as JSON or Prometheus text

reachweaver ops-metrics [-h] [--format {json,prometheus}] [--since SINCE]
                               [--stale-minutes STALE_MINUTES] [--optout OPTOUT] [--out OUT]
                               [--now NOW]

Option	Description
--format FORMAT	Output format (default json) One of: json, prometheus.
--since SINCE	Count audit events from this ISO 8601 time or a relative 30m/24h/7d (default: all time, as Prometheus counters)
--stale-minutes STALE_MINUTES	Mark sending claims older than this threshold as stale (5..10080)
--optout OPTOUT	Opt-out list JSON (default $REACHWEAVER_OPTOUT or config/optout.json if present); queued posts mentioning it are counted, never named
--out OUT	Atomically write this file (mode 0644), e.g. a node_exporter textfile-collector *.prom path; an existing file is replaced only if named *.prom or *.json, never the database or a symlink
--now NOW	Evaluate at this ISO 8601 time instead of the clock (reproducible output)

reachweaver ops-summary

One redacted read-only report: overall readiness, per-account adapter, budget and queue, dead letters and ops-metrics totals; exit 1 when blocked; never contacts providers

reachweaver ops-summary [-h] [--json] [--since SINCE] [--stale-minutes STALE_MINUTES]
                               [--optout OPTOUT] [--now NOW]

Option	Description
--json	Machine-readable report (default: short text)
--since SINCE	Count audit events from this ISO 8601 time or a relative 30m/24h/7d
--stale-minutes STALE_MINUTES	Mark sending claims older than this threshold as stale (5..10080)
--optout OPTOUT	Opt-out list JSON (default $REACHWEAVER_OPTOUT or config/optout.json if present); queued posts mentioning it are counted, never named
--now NOW	Evaluate at this ISO 8601 time instead of the clock (reproducible output)

reachweaver credentials-audit

Offline credential hygiene: env variable NAMES only, never values; exit 1 on findings

reachweaver credentials-audit [-h] [--history FILE] [--json]

Option	Description
--history FILE	Also scan this shell history file for literal REACHWEAVER_* secrets (line numbers only); repeatable
--json	Machine-readable names-only report

reachweaver link-health

Read-only: broken, redirected or preview-less links in stored posts; offline unless –online (robots.txt first, one GET per page, never posts)

reachweaver link-health [-h] [--status STATUS] [--account ACCOUNT]
                               [--campaign CAMPAIGN] [--online] [--allow-origin ORIGIN]
                               [--max-links MAX_LINKS] [--json]

Option	Description
--status STATUS	Post status to scan; repeat (default: approved, scheduled, published)
--account ACCOUNT	Only posts of this account id
--campaign CAMPAIGN	Only posts of this campaign
--online	Allow one GET per distinct landing page (robots.txt first)
--allow-origin ORIGIN	With –online: also follow redirects to this https origin; repeat
--max-links MAX_LINKS	Distinct pages fetched per run, 1..50 (default 25)
--json	Machine-readable result

reachweaver trace

Read-only: everything that happened to one post, oldest first: its audit events and, with –log, the worker-log lines and runs that handled it (issue #26)

reachweaver trace [-h] [--log FILE] [--json] post_id

Option	Description
post_id
--log FILE	A publish –log-json file to join (repeat); ‘-’ reads standard input, e.g. journalctl -u reachweaver -o cat | reachweaver trace ID –log -
--json	Machine-readable trace