Baton

From its catalog listing

Hand your session and repository to your remote Hermes agent (Hermes Cloud, a VPS or a Docker container) with /baton "fix the parser, done when pytest passes": the remote works in a throwaway worktree, cannot return verified until the agreed check is green on the exact tree it returns, and `hermes baton land <id>` fetches the tested branch baton/<id> without touching your HEAD, index, working tree or stash. Code travels by git, the order by the Hermes Runs API, state by git refs; every step resumes after a network cut.

Good to know before installing

pushes a snapshot commit of the repository (tracked changes and untracked files not ignored by .gitignore; a blocking secret scan first refuses .env files, keys and tokens, and symlinks that point outside the repository are refused) to the git remote you configure in remote_git and fetches baton refs from it; sends the task and a redacted session transcript (`hermes sessions export --redact` plus an extra redaction pass, capped at 64 KB) to the peer Hermes API server at the URL you register, with the peer key read through Hermes's secret scope; runs `git` (with a minimal environment) and `hermes sessions export` as subprocesses; on a machine set to role remote or both, runs the agreed check without a shell only when its argv matches the remote's allowed_checks plus safe flags, with an empty throwaway HOME, no HERMES_* variables or provider keys, and a timeout. Without a usable bubblewrap (e.g. the official Docker image) or with sandbox: off, the project's code runs with the remote user's rights and can read the Hermes home, so only accept batons from your own machines. Landing creates branch baton/<id> without touching HEAD, the index or the working tree; no telemetry.

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 baton
  2. Said no? Turn it on later:
    hermes plugins enable baton
  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 · Automation & multi-agent
Maintained by
4n0nn43x (Community)
Needs
No API keys declared
Adds tools
baton_receive baton_check baton_return
Adds hooks
pre_verify
Works on
linux, macos
Needs Hermes
0.23.0 or newer
Version
0.1.0
In the catalog
2026-11-10

Known issues (from its catalog listing)

  • Tested on Linux; macOS is not tested yet. Windows is not supported.
  • Both sides need the plugin installed and a git remote they can both push to and fetch from.
  • Reaching a Hermes Cloud instance depends on that instance exposing the API server (not verified on Hermes Cloud).
  • Without a usable bubblewrap on the remote (the case inside the official Docker image, tested with demo/run-docker.sh), the check runs unsandboxed and the project's code can read the Hermes home by absolute path.
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