Skip to main content

Hermes plugin: cooperate with OpenWolf .wolf/ project state (anatomy/cerebrum/memory)

Project description

openwolf-hermes

Hermes Agent plugin that cooperates with OpenWolf project state (.wolf/anatomy.md, .wolf/cerebrum.md, .wolf/memory.md, .wolf/token-ledger.json).

What it does

Hermes' plugin protocol exposes pre_tool_call (mutates tool args) and register_command (slash commands). It does not expose system-prompt injection. So this plugin cannot make Hermes "read .wolf/anatomy.md before file reads" the way Claude Code hooks can. Instead it provides:

  1. Passive bookkeeping — when Hermes calls a file-read or file-edit tool in a project that has a .wolf/ directory, the plugin appends an entry to .wolf/memory.md and updates session counters in .wolf/token-ledger.json. No prompt injection, no LLM-visible warning.
  2. /openwolf slash command/openwolf status shows the current project's .wolf/ state; /openwolf scan runs openwolf scan as a subprocess.

For full hook-driven OpenWolf experience, use Claude Code. Hermes gets the state-maintenance half but not the auto-injection half (Hermes API limit).

Install (dev)

HERMES_PY="$(dirname $(realpath $(which hermes)))/python"
uv pip install --python "$HERMES_PY" -e <openwolf-fork>/src/agents/hermes/python

Then add openwolf to ~/.hermes/config.yaml:

plugins:
  enabled:
    - openwolf

Restart Hermes.

The OpenWolf adapter automates all of the above:

openwolf init --agent hermes

Status

Alpha. Lives in the OpenWolf fork at src/agents/hermes/python/. PyPI publish deferred until plugin API stabilizes (see ADR-001 Phase 4).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openwolf_hermes-0.1.0.tar.gz (4.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

openwolf_hermes-0.1.0-py3-none-any.whl (4.7 kB view details)

Uploaded Python 3

File details

Details for the file openwolf_hermes-0.1.0.tar.gz.

File metadata

  • Download URL: openwolf_hermes-0.1.0.tar.gz
  • Upload date:
  • Size: 4.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for openwolf_hermes-0.1.0.tar.gz
Algorithm Hash digest
SHA256 6f97f70a522b4580b1edcbf1f826a372607c273c15fa54c941a78f2744d24af2
MD5 4e797b2cc98455401c1e5a25a72ee465
BLAKE2b-256 03305bf8079fcc7dacd91fffcaa6d7a991cdbebbd1aded316cbdf2ae32cb76dd

See more details on using hashes here.

File details

Details for the file openwolf_hermes-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for openwolf_hermes-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b64fcc279af85c210a50911a4faa2bd66b178d9a85465c69487748928dfe62a4
MD5 ee5ed032794f5871000fe840e6ab9d63
BLAKE2b-256 1d1df85a585ce29342f5c3c2a612e09dc606412de73c6e95e2aa53835208c776

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page