← Back to Skills Marketplace
matthewxmurphy

Homebrew Bridge

by Matthew Murphy · GitHub ↗ · v0.6.1 · MIT-0
cross-platform ⚠ suspicious
406
Downloads
0
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install homebrew-bridge
Description
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 optio...
README (SKILL.md)

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/\x3Ctool> 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/\x3Ctool> 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
Usage Guidance
This skill appears to do what it claims, but review and consider the following before installing: - The wrappers will execute commands on the remote Mac as the supplied user@host via SSH. Ensure you only point wrappers at trusted Mac nodes and that the SSH account has the expected privileges. - If you provide an SSH private key or a custom known_hosts file, keep those files secure; the scripts will reference the paths you pass in but do not attempt to hide or encrypt them. - The installer may read your OpenClaw config (~/.openclaw/openclaw.json) for auto-discovery — ensure that file contains only expected remoteHost entries. - Wake-on-LAN sends UDP broadcast packets and requires python3; verify your network policies allow this and that MAC addresses are correct. - The wrappers create executable scripts in the chosen target directory; inspect the generated wrapper script (it is human-readable) before putting it on a production gateway. - Do not use this for WAN/remote hosts or for exposing Mac-only privileged tools; the README already warns against that. If any of the above is unacceptable, do not install or run the scripts; otherwise the package is coherent for the documented use case.
Capability Analysis
Type: OpenClaw Skill Name: homebrew-bridge Version: 0.6.1 The skill bundle facilitates remote command execution by generating executable bash wrappers that tunnel commands to a Mac node via SSH (scripts/install-wrapper.sh). While the logic is transparent and aligned with the stated goal of exposing Homebrew tools to a Linux gateway, the creation of executable scripts and the reliance on SSH for remote execution are high-risk capabilities. The bundle also includes automated host discovery by parsing local OpenClaw configuration files and a Wake-on-LAN feature implemented via Python socket programming (scripts/install-homebrew-pack.sh).
Capability Assessment
✓ Purpose & Capability
The name/description (expose /opt/homebrew/bin tools from a Mac to a Linux gateway) matches the delivered scripts and instructions. The scripts create SSH wrappers, optionally use Wake-on-LAN, and perform OpenClaw config auto-discovery — all coherent with the stated purpose.
✓ Instruction Scope
SKILL.md instructs running the included scripts which read the OpenClaw config (~/.openclaw/openclaw.json) for optional auto-discovery and create wrapper binaries in a specified target directory. The wrappers execute the remote Homebrew binary over SSH and optionally send UDP Wake-on-LAN packets via python3. There are no instructions to read unrelated system files or to send data to unknown external endpoints.
✓ Install Mechanism
This is an instruction-only skill (no network downloads or package installs). The scripts are provided in the bundle and write wrapper files into the user-specified target directory. No remote install URLs or archive extraction steps are present.
✓ Credentials
The skill declares no required environment variables or credentials. The runtime behavior relies on standard local items (SSH access, optional SSH key and known_hosts file if supplied, python3 for WOL, and an OpenClaw config file for discovery). These are proportional to the skill's purpose.
✓ Persistence & Privilege
The skill does not request always:true or elevated platform privileges, and it does not modify other skills or global agent settings. It will create wrapper binaries in the supplied target directory, which is expected behavior for this functionality.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install homebrew-bridge
  3. After installation, invoke the skill by name or use /homebrew-bridge
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.6.1
Patch wrapper forwarding refresh and ClawHub-managed bridge install.
v0.6.0
# homebrew-bridge 0.6.0 - Added ClawHub card emoji metadata. - No behavior change; this is a presentation and registry metadata update.
v0.5.0
# homebrew-bridge 0.5.0 - First public release. - Adds same-LAN wrapper installation for Mac Homebrew tools exposed to a Linux OpenClaw gateway. - Covers `brew`, `gh`, and other `/opt/homebrew/bin` tools with optional Wake-on-LAN and config auto-discovery.
Metadata
Slug homebrew-bridge
Version 0.6.1
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 3
Frequently Asked Questions

What is Homebrew Bridge?

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 optio... It is an AI Agent Skill for Claude Code / OpenClaw, with 406 downloads so far.

How do I install Homebrew Bridge?

Run "/install homebrew-bridge" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Homebrew Bridge free?

Yes, Homebrew Bridge is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Homebrew Bridge support?

Homebrew Bridge is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Homebrew Bridge?

It is built and maintained by Matthew Murphy (@matthewxmurphy); the current version is v0.6.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments