check-data-footprint

Measures claude-watchman's own journal data footprint against retention windows and journals prune findings.

2|Updated Jun 14, 2026
One-click install
npx skills add https://github.com/odysseyalive/claude-watchman --skill check-data-footprint-odysseyalive
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: check-data-footprint
Source: https://github.com/odysseyalive/claude-watchman/tree/main/skills/grammar/check-data-footprint
Command: npx skills add https://github.com/odysseyalive/claude-watchman --skill check-data-footprint-odysseyalive

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? A monitoring tool that collects findings, metrics, logs, and backups can quietly grow until it fills the very disk it watches. This Skill audits claude-watchman's own collected data under journal/ so the monitor never becomes the thing consuming the host's storage. ## Core Features & Use Cases - Footprint measurement: Sizes every artifact class (findings database, WAL/SHM sidecars, run.log, cost ledger, backups, monitor-state snapshots) via read-only retention_report and retention_total_mb calls. - Prunable-data enumeration: Counts terminal findings, old metrics/runs rows, oversized run.log, excess backups, and stale monitor-state snapshots without deleting anything. - Threshold-based journaling: Raises a single deduplicated finding (info/low/medium severity by growth) only when the footprint exceeds WATCHMAN_DATA_FOOTPRINT_WARN_MB or stale data exists, and records a trend metric. - Use Case: During a scheduled /watchman audit loop, the Skill detects that journal/ holds 71MB with 312 terminal findings older than 180 days, and journals a review-tier finding so the operator can prune it later via watchman fix. ## Quick Start Run the check-data-footprint skill during a watchman audit to measure the journal data footprint and report anything past its retention window.

Frequently Asked Questions about check-data-footprint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check how much disk space claude-watchman's journal is using?▼

Run bash lib/wm retention_report to get per-class sizes and a TOTAL row, or bash lib/wm retention_total_mb for the whole-megabyte total. This Skill runs both automatically during every watchman audit and compares the total against WATCHMAN_DATA_FOOTPRINT_WARN_MB.

How do I find old findings and logs that can be pruned?▼

Use bash lib/wm journal_prune_candidates for database rows past their retention windows and bash lib/wm retention_file_candidates for oversized run.log, excess backups, and stale monitor-state snapshots. Both are read-only scans that delete nothing.

Does this check delete old monitoring data automatically?▼

No. The Skill is strictly read-only: it measures, enumerates prunable data, and journals a review-tier finding. Actual pruning happens only through watchman fix with explicit operator confirmation, and journal_prune always backs up findings.db first.

What retention settings control the data footprint check?▼

Retention is tuned in config/watchman.conf: WATCHMAN_DATA_FOOTPRINT_WARN_MB (default 50), WATCHMAN_RETAIN_FINDINGS_DAYS (180), WATCHMAN_RETAIN_METRICS_DAYS (90), WATCHMAN_RETAIN_RUNS_DAYS (90), WATCHMAN_RETAIN_RUNLOG_MB (10), WATCHMAN_RETAIN_BACKUPS (5), and WATCHMAN_RETAIN_MONITOR_DAYS (30).

Why does the check journal no finding on some runs?▼

When the total footprint is under the warn cap and no prunable data exists, the Skill records only the trend metric and journals nothing. This quiet-by-default behavior prevents alert fatigue on a tidy monitor.