bot/docs/cli/memory.md

summary, read_when, title

summary	read_when	title
CLI reference for `hanzo-bot memory` (status/index/search)	You want to index or search semantic memory You’re debugging memory availability or indexing	memory

hanzo-bot memory

Manage semantic memory indexing and search. Provided by the active memory plugin (default: memory-core; set plugins.slots.memory = "none" to disable).

Related:

• Memory concept: Memory
• Plugins: Plugins

Examples

hanzo-bot memory status
hanzo-bot memory status --deep
hanzo-bot memory status --deep --index
hanzo-bot memory status --deep --index --verbose
hanzo-bot memory index
hanzo-bot memory index --verbose
hanzo-bot memory search "release checklist"
hanzo-bot memory status --agent main
hanzo-bot memory index --agent main --verbose

Options

Common:

• --agent <id>: scope to a single agent (default: all configured agents).
• --verbose: emit detailed logs during probes and indexing.

Notes:

• memory status --deep probes vector + embedding availability.
• memory status --deep --index runs a reindex if the store is dirty.
• memory index --verbose prints per-phase details (provider, model, sources, batch activity).
• memory status includes any extra paths configured via memorySearch.extraPaths.
• If effectively active memory remote API key fields are configured as SecretRefs, the command resolves those values from the active gateway snapshot. If gateway is unavailable, the command fails fast.
• Gateway version skew note: this command path requires a gateway that supports secrets.resolve; older gateways return an unknown-method error.