SkillHub

homebrew-bridge

v0.6.1

Expose Mac Homebrew tools like brew, gh, and other /opt/homebrew/bin CLIs on a Linux OpenClaw gateway by installing explicit same-LAN SSH wrappers with optional Wake-on-LAN and OpenClaw config auto-discovery.

Sourced from ClawHub, Authored by Matthew Murphy

Installation

Please help me install the skill `homebrew-bridge` from SkillHub official store. npx skills add matthewxmurphy/homebrew-bridge

Homebrew Bridge

Use this skill when the real value is giving a Linux OpenClaw gateway access to a Mac node's Homebrew toolchain.

This skill is for /opt/homebrew/bin/<tool> wrappers such as:

  • brew
  • gh
  • other Homebrew-installed CLIs you want to expose from a Mac node

Use This Skill For

  • Linux gateways that should run Homebrew-backed tools through a Mac node
  • wrapper-backed skills that depend on brew, gh, or another Homebrew CLI
  • same-LAN Mac nodes that already hold the real Homebrew installs
  • optional host auto-discovery from OpenClaw config when only one Mac owner is known

Do Not Use This Skill For

  • tools that are inherently Mac-owned apps or permissioned CLIs like imsg or remindctl
  • Linux-native tools that should be installed on Linux directly
  • WAN-routed Macs or generic remote shell access

Requirements

  • Linux gateway and owning Mac share the same trusted local network or VLAN
  • Linux gateway can SSH to the owning Mac
  • the requested tool exists at /opt/homebrew/bin/<tool> on that Mac
  • the Mac stays awake during work windows or supports Wake-on-LAN

Workflow

1. Render A Tool Ownership Map

Run:

scripts/render-tool-map.sh /home/node/.openclaw/openclaw.json

This prints the inferred or fallback Mac owner for Homebrew-backed tools.

2. Install The Homebrew Pack

Example:

scripts/install-homebrew-pack.sh 
  --target-dir /home/node/.openclaw/bin 
  --tool brew 
  --tool gh 
  --tool claude 
  --default-host [email protected] 
  --wake-map mac-node.local=AA:BB:CC:DD:EE:FF 
  --wake-wait 20 
  --wake-retries 2

Host resolution order:

  • explicit --map tool=user@host
  • --default-host user@host
  • the single discovered remoteHost in the OpenClaw config, if there is exactly one
  • no repeated host questions when the OpenClaw config already resolves the owner

3. Verify The Pack

Run:

scripts/verify-homebrew-pack.sh --target-dir /home/node/.openclaw/bin

Design Contract

  • Linux owns the stable wrapper paths
  • the Mac owns the real /opt/homebrew/bin binaries
  • public skills depend on wrapper paths, not Mac paths
  • wrapper names stay explicit per tool

Files

  • scripts/install-wrapper.sh: create one SSH wrapper for a remote binary
  • scripts/install-homebrew-pack.sh: install a batch of Homebrew-backed wrappers
  • scripts/verify-homebrew-pack.sh: verify the installed wrappers
  • scripts/render-tool-map.sh: print inferred or fallback tool-to-host maps
  • references/skill-readiness.md: publishability rules for Homebrew-backed wrappers