Hermes Remote Hands

From its catalog listing

One Hermes brain on a server, hands on your own Mac. Over plain OpenSSH (e.g. on a tailnet), with no agent, memory or model on the Mac, it adds six tools: mac_computer_use drives the Mac's screen with the same actions, element indices, hard blocks and verify ladder as the built-in computer_use (through cua-driver, in the background), while computer_use keeps driving the server's own screen in the same chat; mac_shell runs commands; mac_file, mac_patch and mac_search read, edit and search code; mac_process runs dev servers in a private tmux server.

Good to know before installing

runs commands, reads and writes files, takes screenshots and sends input on the Mac named by the ssh_host setting, using the system ssh client and the key named in your SSH config (the plugin never reads, stores or copies keys). Every call goes through Hermes's approval gate with its own mac_* keys: commands, typed text and set_value are approved per exact text by default; credential stores, startup files, LaunchAgents, writes into .git or outside the configured project folders, and sensitive commands prompt every time; a pre_tool_call hook sends other tools' calls that mention the Mac or this plugin's code to a single-use approval; unattended runs fail closed (all of this while Hermes approvals are on, not in YOLO mode). No third-party network calls or telemetry. Background processes: an SSH ControlMaster for up to 30 s after the last call (socket under $HERMES_HOME/cache/ssh), one `ssh … cua-driver mcp` session per chat while mac_computer_use is in use, and mac_process jobs in `tmux -L hermes` on the Mac.

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 hermes-remote-hands
  2. Said no? Turn it on later:
    hermes plugins enable hermes-remote-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
Memory & notes · Chat apps & voice
Maintained by
Vishnu-Aithal (Community)
Needs
No API keys declared
Adds tools
mac_shell mac_file mac_patch mac_search mac_process mac_computer_use
Adds hooks
pre_tool_call on_session_finalize on_session_reset post_compaction
Works on
linux, macos
Needs Hermes
0.23.0 or newer
Version
0.5.3
In the catalog
2026-11-14

Known issues (from its catalog listing)

  • Uses private Hermes internals (tools.computer_use tool/schema/cua_backend/cua_backend_session, tools.approval.request_tool_approval and check_all_command_guards) so mac_computer_use behaves exactly like computer_use. It checks them before use and fails closed with a clear message if a release renames one; re-run the plugin's self-tests after updating Hermes.
  • The Mac needs Remote Login, Command Line Tools (python3, used to resolve paths safely), tmux and ripgrep; projects under ~/Documents, ~/Desktop or ~/Downloads also need 'Allow full disk access for remote users'. Screen control needs cua-driver (verified 0.44.0; other versions log a warning) with its permissions granted at the Mac.
  • The tools appear only after the ssh_host and home settings are set. The Mac must be awake and unlocked for screen control; there is no detection of the user typing at the same moment.
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 memory & notes

All memory & notes plugins

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

← All plugins