agentdb-remember

Remember

Persist a memory into AgentDB so a future session can recall it. Three flavors — pick the right one for what's being remembered:

When to use which

User phrasing	Use
"remember that X works for Y"	Pattern — agentdb_pattern_store
"save what happened when I tried X"	Episode (Reflexion) — agentdb_reflexion_store
"this is a reusable approach for problem X"	Skill — agentdb_skill_create

Pattern (most common)

agentdb_pattern_store(
  content: "JWT refresh token rotation pattern: ...",
  metadata: { topic, project, success: true }
)

Use for facts, conventions, anti-patterns, or anything that should resurface as a hint when a similar query comes up later.

Episode

agentdb_reflexion_store(
  sessionId: <session>,
  task: <what we were trying to do>,
  input: <what we tried>,
  output: <what happened>,
  critique: <what we'd do differently>,
  reward: 0..1,
  success: true|false
)

Use right after a task completes — success OR failure. Failed episodes feed getCritiqueSummary; successful ones feed getSuccessStrategies.

Skill

agentdb_skill_create(
  name: <short verb-noun>,
  description: <what it does>,
  precondition: <when to use>,
  action: <how to do it>,
  outcome: <what success looks like>
)

Use when a pattern has been validated 3+ times and you want it elevated to a first-class reusable skill (queryable by intent embedding).

Don't

• Don't store secrets, API keys, or PII. AgentDB has no built-in redaction. The agentdb-aidefence plugin (separate) handles that — without it, treat the .rvf as containing whatever you put in it.
• Don't store huge blobs. The pattern store is for retrieval signals, not file storage. Use a real blob store + put the URL in metadata.
• Don't store low-quality patterns to "be safe" — recall quality degrades fast under noise. If reward < 0.3, prune it on the next consolidation pass.