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
- 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 - Said no? Turn it on later:
hermes plugins enable hermes-roam - 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_KEYAPI key- Adds tools
roam_statusroam_pushroam_pull- Adds hooks
on_session_starton_session_endpre_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

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