Borrowed Hands

From its catalog listing

Lend your Mac's Xcode to a cloud Hermes. Hermes finds your paired Mac, compiles the Xcode project you granted (macOS arm64 or generic iOS Simulator, compile only) at an exact commit on a bh/* branch, and gets structured compiler diagnostics back: ask "Build my demo project on my Mac", or have Hermes edit a repository with its own git tools, build its bh/* branch, fix what the compiler reports and check with `hands_job` `check_pr_ready` before it opens a pull request (the plugin never pushes, opens pull requests or holds GitHub credentials). Needs the separate Borrowed Hands Mac helper (Python source in the same repository) on an Apple silicon Mac with Xcode; the Mac connects out to Hermes and decides what may build.

Good to know before installing

when `listen.enabled` is set (off by default) the plugin runs an HTTP/WebSocket listener inside `hermes gateway run` (default bind `0.0.0.0:8790`, routes `/bh/v1/ws` and an unauthenticated `/bh/v1/healthz`) that paired Macs dial into; connections are authenticated by a single-use pairing code and per-device Ed25519 keys. It keeps a server signing key and a SQLite database (paired device keys, signed job contracts, build diagnostics, audit log) in its plugin data dir; anything the agent can reach on the gateway host can read that key, and a holder of it can sign build requests to paired Macs within their grants. For a build with no commit it makes one anonymous HTTPS read of the granted public repository's branch list (public addresses only, no credentials, no redirects). With `check_pr_ready` it makes one more such read, for that build's repository. It registers one read-only skill, `borrowed-hands:xcode-build-pr` (text only: the order to use the tools in), and its system prompt section tells the agent to run the bundled standard-library script `templates/new_swiftui_app.py` with its own shell tool to write a new Xcode project into its working directory (no process, no network, nothing overwritten). `/hands whoami`, in a DM, tells any sender their own platform:user_id and nothing else. Builds ask for Hermes approval; an "always" answer covers the same Mac, workspace, scheme, configuration and destination but not the commit or branch, so later commits build without a new prompt. The separate Mac helper is installed by the user from the repository, is not covered by this catalog pin, and installs a LaunchAgent, a hidden build user, a root-owned dispatcher and a sudo rule limited to six exact dispatcher commands. No telemetry, no self-update.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install borrowed-hands
  2. Said no? Turn it on later:
    hermes plugins enable borrowed-hands
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Coding & developer tools
Maintained by
alext8900 (Community)
Needs
No API keys declared
Adds tools
hands_find hands_system_info hands_xcode_build hands_job hands_screen_capture
Adds hooks
pre_tool_call post_tool_call
Works on
linux, macos
Needs Hermes
0.22.7 or newer
Version
0.2.0
In the catalog
2026-11-10

Known issues (from its catalog listing)

  • hands_screen_capture is registered but unavailable: no helper executor in this version.
  • iOS Simulator support is compile-only: no boot, install, UI or tests.
  • Public HTTPS repositories and bh/* commits only; private repositories and remote Swift packages are unsupported.
  • Builds report wipe_ok=false for protected per-user state; complete persistent-state removal is not established.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in coding & developer tools

All coding & developer tools plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins