OpenClaw · Skill
Brew Audit
Quickly audit your Homebrew installation for outdated packages, cleanup opportunities, and health issues.
Install
Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.
Primary command
clawhub install rogue-agent1/brew-auditClawHub installer
npx clawhub@latest install rogue-agent1/brew-auditOpenClaw CLI
openclaw skills install rogue-agent1/brew-auditDirect OpenClaw install
openclaw install rogue-agent1/brew-auditWhat this skill does
Quickly audit your Homebrew installation for outdated packages, cleanup opportunities, and health issues.
Why it matters
Combines outdated listing, cleanup estimates, and brew doctor diagnostics into one command instead of running three separate brew commands and interpreting their output manually.
Typical use cases
- Finding which packages need updates before a macOS upgrade
- Estimating disk space recoverable from old Homebrew downloads
- Diagnosing broken symlinks or permission errors after a system update
- Checking cask versions after returning to a development machine
- Running a monthly maintenance check on installed formulae and casks
Source instructions
Homebrew Audit Skill
Quickly audit your Homebrew installation for outdated packages, cleanup opportunities, and health issues.
Usage
# Full audit (outdated + cleanup + doctor + summary)
bash scripts/brew-audit.sh
# Specific sections
bash scripts/brew-audit.sh --section outdated
bash scripts/brew-audit.sh --section cleanup
bash scripts/brew-audit.sh --section doctor
# JSON output (outdated only)
bash scripts/brew-audit.sh --json --section outdated
What It Checks
📦 Outdated Packages
Lists all formulae and casks with newer versions available, with current → available version info.
🧹 Cleanup Opportunities
Shows how many old versions/downloads can be removed and estimated disk savings. Run brew cleanup to reclaim.
🩺 Health Check
Runs brew doctor to detect:
- Formulae with no source (orphaned kegs)
- Deprecated/disabled packages needing replacement
- Permission issues, broken symlinks, config problems
📊 Summary
Total formulae, casks, and Homebrew prefix.
When to Use
- Periodic system maintenance (weekly/monthly)
- Before major upgrades
- When disk space is low
- After noticing build failures (doctor check)
Updating Packages
After reviewing the audit:
brew upgrade # upgrade all outdated
brew upgrade <formula> # upgrade specific package
brew cleanup # remove old versions