Apple Keychain
From its catalog listing
Load Hermes secrets from macOS Keychain, with interactive setup, safe rotation and recovery. Reads explicitly configured Keychain items; operator commands can write items and manage recovery copies. Does not read or edit .env files. Compiles the included C helper locally with Apple developer tools and uses Security.framework and local macOS commands. Imports some private Hermes configuration helpers.
Good to know before installing
registers the apple_keychain secret source: on macOS, once secrets.apple_keychain.enabled is true, Hermes startup reads the configured generic-password items from macOS Keychain and loads them as environment variables, overriding .env and inherited values by default (override_existing: true); on first use it compiles a small native helper from the plugin's own C source with the local Xcode Command Line Tools clang and caches it in ~/Library/Caches/hermes/apple-keychain (shared by all of the user's profiles; a plugin update can require re-authorising the new helper in Keychain Access), and it keeps empty per-item lock files in /private/tmp; the operator commands hermes keychain setup, set, provision and recovery write secrets.apple_keychain in config.yaml and create, rotate, restore or delete Keychain items, and provision copies the inherited environment values of the configured names into Keychain; rotation keeps the old value as a recovery item in the same keychain until the new value verifies (kept with --keep-backup or after a failed rotation until discarded); items the plugin creates trust the helper and /usr/bin/security (so other programs running as the same user can read them through the security CLI without a prompt), or any application with --allow-any-app; subprocesses get only PATH, HOME and TMPDIR; no network calls, no self-update; imports a few private Hermes helpers that can change between releases.
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 apple-keychain - Said no? Turn it on later:
hermes plugins enable apple-keychain - 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
- Security & privacy
- Maintained by
- robbiemu (Community)
- Needs
- No API keys declared
- Works on
- macos
- Needs Hermes
- 0.23.0 or newer
- Version
- 0.1.1
- In the catalog
- 2026-11-10
Using the Hermes desktop app? See where plugins live

Full setup & settings ↗Source code ↗
More in security & privacy
All security & privacy plugins
New Hermes Agent updates every day on X. Follow @HermesWatcher