Homebrew Den

A Homebrew tap for CLI tools and macOS apps by MrDemonWolf, Inc.

Quick Start

brew tap mrdemonwolf/den
brew install <formula>          # CLI tools
brew install --cask <name>      # macOS apps

Available Formulae

Formula	Version	Stability	Description
iconwolf	0.4.0	Alpha	Cross-platform app icon generator for Expo/React Native projects

Available Casks

Cask	Description
wolfwave	Menu bar app bridging Apple Music with Twitch, Discord, and stream overlays

Documentation Site

Browse the full documentation at mrdemonwolf.github.io/homebrew-den.

The site auto-rebuilds on every push to main and includes:

• Dark/light theme with system preference detection
• Cmd+K / Ctrl+K search palette for quick package lookup
• Per-formula and per-cask detail pages with install commands, metadata, caveats, and version history
• Stability badges (Alpha, Beta, RC, Pre-release) based on semver and GitHub Releases

The site is built with Astro (static output, Tailwind CSS v4). To build locally:

npm install                # Install dependencies (first time only)
npm run dev                # Live dev server, or…
npm run build              # Build the static site into _site/
npm run preview            # Serve the built _site/ locally

The build needs Node.js 22+ only. Useful environment knobs:

• OFFLINE=1 — skip all network calls and build with empty version history (explicit local offline mode).
• STRICT_RELEASES=1 — fail the build if the GitHub API is unreachable (set automatically when CI=true) so production never ships pages with version history silently dropped.
• GITHUB_TOKEN — authenticate the GitHub Releases API requests (version history).

Adding a New Formula

Create a file at Formula/<name>.rb pointing at a pre-built release binary:

class <Name> < Formula
  desc "<Short description>"
  homepage "https://github.com/<owner>/<repo>"
  url "https://github.com/<owner>/<repo>/releases/download/v<version>/<name>-macos-arm64.tar.gz"
  version "<version>"
  sha256 "<sha256>"
  license "MIT"

  # Apple-Silicon macOS only: keep the url top-level (a nested on_macos/on_arm
  # url is invalid on other platforms) and restrict installation via depends_on.
  depends_on arch: :arm64
  depends_on :macos

  def install
    bin.install "<name>"
  end

  test do
    assert_match version.to_s, shell_output("#{bin}/<name> --version")
  end
end

Test the formula locally before pushing:

brew install --build-from-source Formula/<name>.rb

Adding a New Cask

Create a file at Casks/<name>.rb using this template:

cask "<name>" do
  version "<version>"
  sha256 "<sha256>"

  url "https://github.com/<owner>/<repo>/releases/download/v#{version}/<name>-#{version}.dmg"
  name "<App Name>"
  desc "<Short description>"
  homepage "https://github.com/<owner>/<repo>"

  app "<App Name>.app"
end

Generate the SHA-256 checksum:

shasum -a 256 <name>-<version>.dmg

Test the cask locally before pushing:

brew install --cask Casks/<name>.rb

Contributing

Running Tests

Tests run automatically on every push and PR via CI. To run locally:

npm install
npm test

License

MIT — © 2026 MrDemonWolf, Inc.