beholder

See structural risk and dependency relationships in code.

A Rust library and CLI that indexes symbols, complexity, references, and cohesion, then compares revisions to rank the structural risk in a change.

Install with Homebrew (macOS, Linux)

brew install wyrd-company/tools/beholder
Terminal output of beholder report listing changed symbols by risk percentile.
A ranked report of the riskiest symbols between two revisions.

What it does

  1. Indexes symbols, nesting-weighted complexity, references and cohesion from the working tree.

  2. Compares two revisions by stable symbol identity and ranks the riskiest changed symbols first.

  3. Renders one analysis as text, JSON, SARIF annotations or a pull request comment.

  4. Stores analysis in a custom Git ref, so results travel with the repository and need no service.

  5. Runs as a GitHub Action that annotates a pull request and keeps one sticky comment.

Install

brew install wyrd-company/tools/beholder

Documentation

Releases

Latest 0.1.1 Release notes on GitHub

Fixes

  • Publish documentation independently of releases, validate changes across supported platforms, and keep manual release builds separate from GitHub, Cargo, npm and Homebrew publication.
All releases