Skip to content

ClAudit v2.10.0

Choose a tag to compare

@github-actions github-actions released this 27 Sep 01:05
· 238 commits to main since this release

Install census: how many nodes run ClAudit, on which version, and whether they are still up. Three sources, merged hourly into docs/nodes.json, an Installs block in the README, a card on the project page, and the Project tab in the app.

  • Anonymous heartbeat (on by default). Every 10 minutes the app or the CLI watcher POSTs {node, v, os, mode, event} to a Cloudflare Worker in telemetry/ (deployed at claudit-census.fogbank.workers.dev). node is a random id made on first run (~/.claude/claudit/node_id); the Worker keeps those fields and a timestamp for eight days and never reads the request IP. A clean quit sends stop. The Worker's cron sorts nodes into running (beat within 30 min), stopped (said stop within 24 h), and quiet (seen within 24 h, then silent: crash, sleep, offline), with version, OS, and install-mode breakdowns at /stats.
  • GitHub heartbeat (off by default, login-visible). Every 6 hours the node creates or edits one comment on #14 under the user's own login: version, OS family, install mode, a short non-reversible node hash, time. Quiet after 24 h without an edit. Delete the comment to leave.
  • Passive census. Every filed issue ends with the version that filed it; the aggregator counts distinct reporters, the version each last used, and 7/30-day activity. No heartbeat involved.
  • Settings gains a Census group with the two toggles (turning the anonymous one off sends a final stop; turning the GitHub one on posts immediately). claudit_scan.py --census prints the live numbers and exactly what this node sends. Config: census_anon, census_github, census_url.
  • Tests: node id persistence and payload shape (no PII fields, hostname and home path asserted absent), tick scheduling for both cadences and the stop, the POST body, the comment upsert (edit own, create when absent, skip when signed out), and the aggregator on fixtures. 120 total.

Install: pip install "claudit-cc[gui] @ https://github.com/sworrl/ClAudit/archive/refs/tags/v2.10.0.tar.gz" or download the wheel below.