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

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install apple-keychain
  2. Said no? Turn it on later:
    hermes plugins enable apple-keychain
  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
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
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 security & privacy

All security & privacy plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins