memory.py 1.7 KB

12345678910111213141516171819202122232425262728293031323334
  1. """``hermes memory`` subcommand parser."""
  2. from __future__ import annotations
  3. from typing import Callable
  4. from hermes_cli.subcommands._shared import add_yes_flag
  5. def build_memory_parser(subparsers, *, cmd_memory: Callable) -> None:
  6. """Attach the ``memory`` subcommand to ``subparsers``."""
  7. memory_parser = subparsers.add_parser(
  8. "memory", help="Configure external memory provider",
  9. description="Set up and manage external memory provider plugins.\n\n"
  10. "Bundled providers: retaindb, byterover.\n"
  11. "Catalog providers (e.g. honcho, hindsight, supermemory,\n"
  12. "mem0, openviking, holographic): hermes plugins install <name>.\n\n"
  13. "Only one external provider can be active at a time.\n"
  14. "Built-in memory (MEMORY.md/USER.md) is always active.")
  15. memory_sub = memory_parser.add_subparsers(dest="memory_command")
  16. _setup_parser = memory_sub.add_parser(
  17. "setup", help="Interactive provider selection and configuration")
  18. _setup_parser.add_argument(
  19. "provider", nargs="?", default=None,
  20. help="Provider to configure directly (e.g. honcho), skipping the picker")
  21. memory_sub.add_parser("status", help="Show current memory provider config")
  22. memory_sub.add_parser("off", help="Disable external provider (built-in only)")
  23. _reset_parser = memory_sub.add_parser(
  24. "reset", help="Erase all built-in memory (MEMORY.md and USER.md)")
  25. add_yes_flag(_reset_parser)
  26. _reset_parser.add_argument(
  27. "--target", choices=["all", "memory", "user"], default="all",
  28. help="Which store to reset: 'all' (default), 'memory', or 'user'")
  29. memory_parser.set_defaults(func=cmd_memory)