Skip to content
Apothem
Harnesses

Hermes

Apothem harness adapter for Hermes (Preview).

Vendor: Hermes Install name: hermes Status: Preview Native config: ~/.hermes/config.yaml

Installation

apothem install --harness hermes

The adapter translates the shared profile to the Hermes Agent user-global configuration file and installs Apothem support cohorts under the harness root.

Files written: ~/.hermes/config.yaml and support files under ~/.hermes/.apothem/support/

Profile-to-native-config mapping

The adapter reads Apothem's shared profile and renders the native YAML config. Hermes's own skills surface is skills.config — installable registry packages that Hermes auto-exposes as dynamic slash commands — which Apothem does not author. Apothem instead delivers shared command and skill content as support material under ~/.hermes/.apothem/support/, referenced from the native instruction anchor. Helper definitions, rules, templates, and hook prompts likewise remain support material under ~/.hermes/.apothem/support/.

Compatibility notes

Preview adapter. The native YAML config is the active Hermes surface. There is no skill-directory hook: skills.config is a Hermes vendor registry of installable packages that Apothem never authors. Apothem instead delivers command and skill content — along with the other cohorts — as support material under ~/.hermes/.apothem/support/, referenced from the native instruction anchor.

Verification

apothem verify --harness hermes

The verify command confirms that:

  1. The native config exists at the expected path.
  2. All mandatory fields from the shared profile are present.
  3. The adapter-specific verification routine reports success.

Updating

apothem update --harness hermes

Re-derives the native config from the current shared profile state. Run after editing ~/.config/apothem/profile.yaml or upgrading the installed Apothem package.

Uninstalling

apothem uninstall --harness hermes

Removes the native config files written by the adapter. The shared profile YAML and Apothem engine are unaffected.

Conformity gate

python -m apothem.conformity.gate --all .

Troubleshooting

SymptomFix
Config file not foundRe-run apothem install --harness hermes
Verification failedRun apothem update --harness hermes, then verify again
Unexpected config contentCheck ~/.config/apothem/profile.yaml or --profile PATH, then re-run apothem update --harness hermes

Configuration knobs

FlagDefaultDescription
--dry-runfalsePreview install without writing files.

See also

On this page