Skip to main content

wednesdayai memory

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

Examples

Options

Common:
  • --agent <id>: scope to a single agent (default: all configured agents).
  • --verbose: emit detailed logs during probes and indexing.
memory search:
  • Query input: pass either positional [query] or --query <text>.
  • If both are provided, --query wins.
  • If neither is provided, the command exits with an error.
  • The command runs without session identity, so memory.qmd.scope rules that match on channel or chatType cannot apply and the scope default governs. On the active QMD backend, a denial is reported as an error and the command exits 1 instead of returning empty results; with the default DM-only scope this denies the CLI search entirely — set memory.qmd.scope.default: "allow" to permit identity-less CLI search. A builtin fallback backend does not enforce the scope.
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.