BranchPy
Log in

Docs-Builder

# Telemetry Quick Reference

Version: 1.1.1
Last Updated: January 23, 2026

Commands

  • branchpy telemetry mode --show — display current mode.
  • branchpy telemetry mode manual|auto|off — set mode (default manual).
  • branchpy telemetry preview [--from 2h] [--json] [--full] — inspect package without writing.
  • branchpy telemetry export --output rc-metrics.json [--from 2h] — write sanitized package.
  • branchpy telemetry upload --file rc-metrics.json — upload existing package.
  • branchpy telemetry upload --auto [--from 24h] [--dry-run] [--endpoint URL] — build + send.

Storage Locations

  • CLI/Daemon events: ~/.branchpy/telemetry/events.jsonl
  • CLI SQLite DB: .branchpy/telemetry/events.db
  • VS Code events: %APPDATA%/Code/User/globalStorage/branchpy-team.branchpy/telemetry/*.jsonl (Windows), analogous macOS/Linux paths.

Modes & Defaults

  • Default mode: manual
  • Default time window: --from 2h
  • Auto upload interval: 24h (auto mode only)
  • Upload size cap: 5MB (config)
  • Cache sampling: 100% (can be reduced via env)

API Endpoints (rc-backend)

  • POST /api/telemetry/upload — ingest package
  • GET /api/telemetry/stats — summary totals
  • GET /api/telemetry/events — filtered events
  • GET /api/telemetry/aggregate/category|source|timeline — charts
  • GET /api/telemetry/errors/recent|slo — error views
  • GET /api/telemetry/sessions — session analytics
  • GET /api/telemetry/health — health check

Safety Checks

  • No auto-send in manual mode; auto requires explicit opt-in.
  • Paths and error messages hashed; no content stored.
  • Preview/dry-run recommended before uploads.