Sluice

From its catalog listing

An airlock for agent changes. A terminal backend that runs the agent's commands and file tools (read_file, write_file, patch, search_files) in a staged copy of the workspace, so the real files are untouched until you review the diff hunk by hunk and apply only what you approve (/sluice diff, /sluice apply, /sluice discard, also as `hermes sluice`). Calls a copy cannot contain (git push, package installs, network writes, deploys, writes or deletes outside the workspace) are sent to Hermes's own approval prompt labelled NOT CONTAINED. Select it with `hermes config set terminal.backend sluice`.

Good to know before installing

No network calls and no background processes. Runs the agent's shell commands and file tools on this host as the user, in a staged copy of the workspace kept under <HERMES_HOME>/plugin-data/sluice (every non-gitignored workspace file plus a copy of .git; stages idle 14 days are deleted), and runs `git ls-files` to list files; it never reads Hermes credential files. Only when the user runs `/sluice apply` does it write the approved changes (including new symlinks) into the workspace. One pre_tool_call hook sends calls the copy cannot contain (installs, network writes, git push, writes outside the workspace) to Hermes's approval prompt and never approves anything itself. Not an operating-system sandbox: the hold list reads command text, so Python in execute_code or a command that builds its target path at run time can write outside the workspace without being held.

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 sluice
  2. Said no? Turn it on later:
    hermes plugins enable sluice
  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
orjinameh (Community)
Needs
No API keys declared
Adds hooks
pre_tool_call
Works on
linux, macos
Needs Hermes
0.22.6 or newer
Version
1.0.1
In the catalog
2026-11-07, updated 2026-11-10

Known issues (from its catalog listing)

  • Not an OS sandbox: the gate reads command text, so a command that builds its target path at run time can get past it.
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