steipete’s Homebrew Tap

Homebrew tap for shipping my CLI tools + a few macOS apps.

brew tap steipete/tap
brew trust --tap steipete/tap

# formula
brew install steipete/tap/<name>

# cask
brew install --cask steipete/tap/<name>

• blucli — Play, group, and automate BluOS
• birdclaw — Local Twitter memory for archives, DMs, likes, bookmarks, and moderation
• camsnap — One command to grab frames, clips, or motion alerts from RTSP/ONVIF cams
• codexbar — CodexBar CLI (Linuxbrew)
• eightctl — Control Eight Sleep Pods from the terminal
• gifgrep — Grep the GIF. Stick the landing.
• imsg — Send and read iMessage / SMS from the terminal
• mcporter — Model Context Protocol runtime and CLI generator (0.12.3: typed-array signatures and refreshed dependencies)
• nameplate — Click-through identity overlays for Linux remote-desktop fleets
• oracle — Bundle prompts + files for second-model review
• ordercli — Multi-provider order CLI (Foodora, Deliveroo)
• peekaboo — Lightning-fast macOS screenshots & AI vision analysis
• poltergeist — Universal file watcher with auto-rebuild for any language or build system
• sag — Command-line ElevenLabs TTS with mac-style flags
• sonoscli — Control Sonos speakers from the command line
• songsee — Spectral visualization CLI for audio files
• tmuxwatch — Live tmux dashboard with Bubble Tea UI

• blackbar — Menu bar app for Blacksmith CI status and live vCPU usage
• codexbar — Menu bar usage monitor for Codex and Claude
• repobar — Menu bar GitHub repo status at a glance
• trimmy — Paste-once, run-once clipboard cleaner for terminal snippets

Run the Update Formula workflow with:

• formula: formula name, e.g. tmuxwatch
• tag: release tag, e.g. v0.7.0
• repository: source repository, e.g. steipete/tmuxwatch
• assets: optional JSON object containing exact name and sha256 values for darwin_amd64, darwin_arm64, linux_amd64, and linux_arm64

When assets is present, the updater uses each filename and checksum verbatim, downloads every release asset, and refuses to commit unless the downloaded SHA-256 matches. Without it, the workflow preserves the legacy single-URL, template, alias, and filename-guessing paths for older callers. Formulae with unsupported custom platform layouts still need manual updates.

New release assets may briefly return 404 while publishing; the updater waits with exponential backoff. Concurrent formula updates rebase onto the latest main before retrying their push.

Raw metadata for API-based consumers such as mise is published at api/cask/<token>.json. The Update Cask API Metadata workflow regenerates every cask after direct cask changes and after the release updater completes, including casks changed by that workflow's GitHub token.

To regenerate locally, first make sure steipete/tap is tapped at the same commit as this checkout and trusted with brew trust --tap steipete/tap, then run:

python3 .github/scripts/generate_cask_api.py

OpenClaw-owned formulae live in openclaw/tap; migrated names are listed in tap_migrations.json.

Both macOS workflows use the Apple Silicon xcode-27 runner and explicitly trust the checked-out tap before loading casks. Changes to the cask API updater workflow are also validated on pull requests; those runs generate metadata without committing or pushing it.

Run python3 -B -m unittest discover -s tests -v and brew style Casks/*.rb before submitting changes. The Tap Tests workflow also loads every cask with Homebrew and generates its API metadata on pull requests and pushes to main.

Use a plain url stanza for casks; Homebrew handles URL verification by default and has deprecated the verified: parameter.

brew update
brew upgrade

brew uninstall <formula>
brew uninstall --cask <cask>

# casks only: remove user data
brew uninstall --cask --zap steipete/tap/codexbar

• Run brew info steipete/tap/<name> for per-tool caveats (permissions, setup steps, etc.).

Homebrew formulae don’t support --zap. Delete these to “factory reset”:

• blucli: ~/Library/Application Support/blu/ + ~/Library/Caches/blu/
• birdclaw: ~/.birdclaw/
• camsnap: ~/.config/camsnap/config.yaml
• eightctl: ~/.config/eightctl/config.yaml
• mcporter: ~/.mcporter/
• oracle: ~/.oracle/
• ordercli: ~/Library/Application Support/ordercli/config.json
• sonoscli: ~/Library/Application Support/sonoscli/config.json

All referenced projects live next to this repo under ~/Projects/<repo>.