| """``hermes memory`` subcommand parser.""" | |
| from __future__ import annotations | |
| from typing import Callable | |
| from hermes_cli.subcommands._shared import add_yes_flag | |
| def build_memory_parser(subparsers, *, cmd_memory: Callable) -> None: | |
| """Attach the ``memory`` subcommand to ``subparsers``.""" | |
| memory_parser = subparsers.add_parser( | |
| "memory", help="Configure external memory provider", | |
| description="Set up and manage external memory provider plugins.\n\n" | |
| "Available providers: honcho, openviking, mem0, hindsight,\n" | |
| "holographic, retaindb, byterover.\n\n" | |
| "Only one external provider can be active at a time.\n" | |
| "Built-in memory (MEMORY.md/USER.md) is always active.") | |
| memory_sub = memory_parser.add_subparsers(dest="memory_command") | |
| _setup_parser = memory_sub.add_parser( | |
| "setup", help="Interactive provider selection and configuration") | |
| _setup_parser.add_argument( | |
| "provider", nargs="?", default=None, | |
| help="Provider to configure directly (e.g. honcho), skipping the picker") | |
| memory_sub.add_parser("status", help="Show current memory provider config") | |
| memory_sub.add_parser("off", help="Disable external provider (built-in only)") | |
| _reset_parser = memory_sub.add_parser( | |
| "reset", help="Erase all built-in memory (MEMORY.md and USER.md)") | |
| add_yes_flag(_reset_parser) | |
| _reset_parser.add_argument( | |
| "--target", choices=["all", "memory", "user"], default="all", | |
| help="Which store to reset: 'all' (default), 'memory', or 'user'") | |
| memory_parser.set_defaults(func=cmd_memory) | |