Hermes Roam

From its catalog listing

Encrypted, host-scoped sync of the Hermes Agent home between your own machines: an AES-256-GCM sealed bundle of the shared home (config.yaml minus host-scoped keys, SOUL.md, memories, skills) is pushed to storage you own — an S3 or Cloudflare R2 bucket, a private git repository, or a local directory — and pulled back on another machine through a plan-first, journaled, backed-up, roll-back-able install. Secrets (.env, auth.json, API keys) never sync; pulls apply only on explicit user action (the agent cannot apply by default); conflicts are detected with a signed compare-and-swap head, never merged. Every pushed version stays recoverable (hermes roam history / restore). Works across profiles and bots: one store carries every profile (each profile's identity, SOUL, memories, skills and shared config), from any profile context; a profile can be excluded per device. Opt-in, off by default: a read-only, encrypted archive of session transcripts (exported with hermes sessions export --redact) that other devices can list and read, and cron job definitions (pulled jobs land paused until hermes cron resume).

Good to know before installing

network calls only to the user-configured store (boto3 for S3/R2, the git CLI for the git backend) and only when a roam command, tool, slash verb or session hook actually runs; the git backend also runs git as local subprocesses with an allowlisted environment, the opt-in session archive runs hermes sessions export once per profile, and hermes roam auto runs hermes config set, all as bounded local subprocesses; the shared ROAM_ARCHIVE_KEY and S3 credentials come only through Hermes's secret scope, never from files; session hooks run bounded daemon threads; no telemetry, no self-update.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs (this one needs ROAM_ARCHIVE_KEY), then asks whether to turn it on.
    hermes plugins install hermes-roam
  2. Said no? Turn it on later:
    hermes plugins enable hermes-roam
  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
Victor Cruz (Community)
Needs
ROAM_ARCHIVE_KEY API key
Adds tools
roam_status roam_push roam_pull
Adds hooks
on_session_start on_session_end pre_llm_call
Needs Hermes
0.22.0 or newer
Version
0.5.6
In the catalog
2026-11-09

Known issues (from its catalog listing)

  • The git backend is unsuitable for large homes: git hosts cap file sizes (~100 MB per file on GitHub), so keep the shared home well under ~50 MB there and use the S3/R2 backend for larger homes.
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