memory-shield.yaml 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051
  1. name: memory-shield
  2. title: Memory Shield
  3. repo: https://github.com/churnast/hermes-memory-shield
  4. sha: 347ab18408da52937f7e808a6e88a52b74184225
  5. description: >-
  6. Keeps your agent from rewriting or wiping what it remembers about you: by default the agent may add facts
  7. to the owner profile (USER.md) wherever it may write and may correct one only when the owner asks in a
  8. direct chat, the CLI or a trusted chat, and nobody may delete one; the agent's notes (MEMORY.md) cannot
  9. be deleted; group chats are read-only except for the people and owner-only chats you trust, and once
  10. trusted_users is set a direct chat with anyone not listed is read-only too; Hermes' unattended
  11. background review may not touch the owner profile. Block, ask through Hermes' approval prompt or just
  12. log, and undo edits and deletions from snapshots.
  13. Disclosure — no network calls, credentials, shell commands or background processes. One pre_tool_call hook
  14. reads the turn's platform, chat type, chat id and name, sender id and name and the cron flag
  15. (gateway.session_context) and whether the run is Hermes' unattended review
  16. (tools.skill_provenance.is_unattended_review), checks memory tool calls, and checks write_file, patch,
  17. terminal and execute_code calls only for a write into, or a removal of, USER.md, MEMORY.md or the memory
  18. folder (reading a memory file or copying it elsewhere passes in calls up to 16 KB; a longer call that names
  19. them is refused); mode approve asks through Hermes' approval gate in the owner's direct chats and the CLI
  20. and blocks in shared chats, cron and direct chats with people not in trusted_users. Writes
  21. plugin-data/memory-shield/audit.jsonl (the last 500 refused or flagged writes: time, chat, sender and a
  22. 160-character excerpt) and snapshots/ (full copies of USER.md and MEMORY.md taken right before an allowed
  23. edit or deletion, 20 per file by default). Reads the memory files and holds the memory store's lock files
  24. while it reads or writes them (not on Windows); /memory-shield restore overwrites one memory file.
  25. /memory-shield log and restore answer only in direct chats, the CLI and trusted_chats, and once
  26. trusted_users is set only the people listed there (a session without a user id, such as the CLI, counts as
  27. the owner); /memory-shield, snapshots and whoami answer in any chat with settings, counts, times, sizes and
  28. the caller's own id, name and chat key.
  29. maintainer: churnast
  30. tier: community
  31. category: general
  32. requires_hermes: ">=0.21.5"
  33. docs_url: https://github.com/churnast/hermes-memory-shield#readme
  34. version: "1.1.2"
  35. image: https://raw.githubusercontent.com/churnast/hermes-memory-shield/347ab18408da52937f7e808a6e88a52b74184225/docs/card.png
  36. screenshots:
  37. - https://raw.githubusercontent.com/churnast/hermes-memory-shield/347ab18408da52937f7e808a6e88a52b74184225/docs/screenshots/01-group-stranger.png
  38. - https://raw.githubusercontent.com/churnast/hermes-memory-shield/347ab18408da52937f7e808a6e88a52b74184225/docs/screenshots/02-forget-everything.png
  39. - https://raw.githubusercontent.com/churnast/hermes-memory-shield/347ab18408da52937f7e808a6e88a52b74184225/docs/screenshots/04-undo.png
  40. platforms: [linux, macos]
  41. known_issues:
  42. - "Needs plugins.isolation: in_process (the default). Under plugins.isolation: host the plugin cannot see the current chat, sender or Hermes' review marker, so it judges every call like a direct chat and the group chat and background review protection does not apply."
  43. - "Covers Hermes' built-in memory tool (USER.md, MEMORY.md) only, not the tools of memory provider plugins such as Honcho or Mem0."
  44. - "Without trusted_users every direct chat counts as the owner: whoever can message the agent directly may add facts to the owner profile and correct them (not delete them) until the owner's id is listed."
  45. - "Spotting USER.md and MEMORY.md edits made through terminal and execute_code is best effort: a path built some other way, or a command run from a script file, can get through."
  46. - "terminal and execute_code calls are read up to 16,384 characters. A longer call that contains the word memories, USER.md or MEMORY.md (any case, quotes ignored) is refused even when it only reads them; a longer call that contains none of them passes without being read."
  47. capabilities:
  48. provides_tools: []
  49. provides_hooks: [pre_tool_call]
  50. provides_middleware: []
  51. requires_env: []