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
- Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
hermes plugins install hermes-remote-hands - Said no? Turn it on later:
hermes plugins enable hermes-remote-hands - 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_shellmac_filemac_patchmac_searchmac_processmac_computer_use- Adds hooks
pre_tool_callon_session_finalizeon_session_resetpost_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

Full setup & settings ↗Source code ↗
More in memory & notes
New Hermes Agent updates every day on X. Follow @HermesWatcher