Skip to content
CAI
Software that uses CAICheck a score

buo/homebrew-cask-upgrade

51.2

Weak · 5 November 2026

1k

lines of production code

Ruby

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This system is a Homebrew Cask upgrade tool that manages software updates for macOS applications. It provides commands to upgrade, pin, and livecheck casks, while also integrating support for Mac App Store applications. The tool offers both interactive and non-interactive modes to facilitate safe and selective upgrades in various environments.

Features

Introduce cask pinning and livecheck commands

This change adds a new pinning system that allows users to prevent specific casks from being upgraded, along with commands to manage these pins (add, remove, list, export, and load from a file). It also introduces a \livecheck\ command to check for available updates for all casks and integrates Mac App Store (MAS) applications into the upgrade and pinning workflows, including support for interactive upgrades where users can pin apps during the process.

lib/bcu/command · high confidence

Introduction of \`brew cu\` command and non-interactive wrapper

This change introduces the \brew cu\ command for upgrading Homebrew Casks, featuring support for pinning/unpinning specific casks, interactive mode for selective upgrades, and various options such as \--quiet\, \--verbose\, \--no-brew-update\, and \--no-quarantine\. It also adds a \brewcask-upgrade\ wrapper script that provides a non-interactive interface by automatically rejecting interactive prompts, ensuring safe execution in automated environments.

cmd · high confidence

Behavioural changes

Improved cask loading and table formatting

The tool now manually retrieves installed apps to avoid errors during iteration and loads casks using the preferred installed version, ensuring more reliable detection of outdated software. Output formatting has been refactored into a dedicated module that supports responsive table layouts, colorized status indicators, and optional verbose details like full version strings and URLs, providing a clearer and more robust user experience.

lib/extend · high confidence

Migrate from legacy Hbc API to Homebrew External Command support

The tool has been rewritten to utilize Homebrew's External Command support, replacing the previous standalone script (lib/brew-cask-upgrade.rb) with a new entry point (lib/bcu.rb). This change removes the direct dependency on the legacy 'hbc' library and its associated vendor forks, instead loading Homebrew's internal cask libraries via the load path and delegating execution to specific command modules (e.g., Upgrade, Pin, Livecheck) based on user arguments.

lib · high confidence

New compatibility shim and refactored option parsing

The library now includes a compatibility layer (\lib/bcu/compat.rb\) to handle Homebrew API changes, specifically delegating to \Utils::Output.redirect\_stdout\ for Homebrew 7.0.0+ while falling back to the legacy method for older versions. Additionally, option parsing (\lib/bcu/options.rb\) has been refactored to support new commands and flags such as \--include-mas\, \--report-only\, and \--no-brew-update\, while deprecating short options like \-p\ and \-u\ in favor of explicit long-form flags.

lib/bcu · high confidence

Shell script wrapper for Homebrew cask-upgrade

The bin/brew-cask-upgrade script has been rewritten from a Ruby implementation to a shell script that invokes the Homebrew cask-upgrade command. It now checks for the existence of the brew executable and attempts to run the upgrade; if the command fails, it automatically taps the buo/cask-upgrade repository and retries the upgrade operation.

bin · high confidence

Dependencies

Update to version 2.0.2 with Ruby 4.0 requirement

The brew-cask-upgrade gem has been updated to version 2.0.2, which now requires Ruby version 4.0.0 or higher. This change also includes minor metadata updates such as adding a frozen string literal directive and specifying multi-factor authentication requirements for RubyGems.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 51 → 51 (+0.0)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 74 → 74 (+0.0)
  • Architecture 69 → 69 (+0.0)
  • Maturity 49 → 49 (+0.0)
  • Readiness 41 → 41 (+0.0)
  • Security 78 → 78 (+0.0)

Resolved (4)

  • Duplicate methods with 'print_' and 'output_print_' prefixes. The 'output_' prefix likely indicates a specific output stream or format, but the naming is redundant and confusing. It is unclear why both exist and when to use which.
  • Duplicate methods within the same class 'Remove'. 'remove_pin' and 'run_remove_pin' appear to do the same thing, with 'run_' possibly indicating an async or wrapped call, but this is not clear from the signature.
  • Off-boarding risk: anonymized user #1
  • Two methods for redirecting stdout, one marked 'legacy'. This is acceptable if 'legacy' is clearly deprecated, but the naming 'redirect_stdout' vs 'legacy_redirect_stdout' is slightly inconsistent with standard deprecation patterns (e.g., 'redirect_stdout' and 'redirect_stdout_deprecated').

New (1)

  • Off-boarding risk: anonymized user #1

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

buo/homebrew-cask-upgrade was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 5 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit d42afd9212b967b04809d0c63d830caee1484cd7 — the exact code this score is about.
  • Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.2+preprod-5c4e66d9318b.