Skip to main content

ovecc history

Trends one snapshot metric across every index run: per-snapshot values, deltas, and a sparkline. The data is already persisted at every ovecc index — 26 metrics per snapshot — so this command just renders it.

Usage: ovecc history [OPTIONS] [METRIC]

Example​

Without a metric, list everything trendable:

$ ovecc history
Trendable metrics (26):
  apis
  boundary_violations
  circular_dependencies
  coupling_density
  dependency_advisories
  high_complexity_functions
  max_cyclomatic
  security_findings
  unused_exports
  ...
Run `ovecc history <metric>` to trend one.

With one:

$ ovecc history unused_exports
History: unused_exports over 3 snapshot(s)   8 -> 0 (-8)
  ▇█▁
  2026-07-11T09:35:24…  d9416a8           8
  2026-07-11T09:35:25…  1a67876          10  +2
  2026-07-11T09:36:59…  e8fa485           0  -10

Each row: snapshot timestamp, commit, value, delta. The header gives the first→last change; the sparkline shows the shape at a glance.

Options​

OptionDefaultEffect
[METRIC]—Metric to trend (e.g. coupling_density, high_complexity_functions)
--limit <N>20Keep only the most recent N snapshots

Plus the global options.

Notes​

  • Text/markdown output rounds ratios to three decimals; JSON and NDJSON keep raw float values for machines.
  • Snapshots only exist where you ran index — a contiguous history needs indexing in your merge pipeline (see drift & trends).