remember

Remember a decision, plan, idea, claim, artifact, session, or learning. remember is the write side of the Sibyl memory loop. It captures a titled memory and routes it into the graph, or stores it verbatim as a raw memory or private agent diary entry.

Synopsis

sibyl remember <title> [content] [options]

Content is read from stdin when the positional argument is omitted.

Arguments

Argument	Required	Description
title	Yes	Title/name of the memory
content	No	Memory body. Reads stdin if omitted

Options

Option	Short	Default	Description
--content		(none)	Memory body (alternative to positional)
--content-file		(none)	Read content from a file
--max-size		1048576	Maximum content file size in bytes
--follow-symlinks		false	Allow --content-file to read through symlinks
--kind	-k	episode	Entity type to create (see entity)
--domain	-d	(none)	Domain/category
--project	-p	(auto)	Project ID
--all-projects		false	Do not auto-scope to the linked project
--tags		(none)	Comma-separated tags
--related-to		(none)	Comma-separated entity IDs to connect with RELATED_TO
--task		(none)	Comma-separated task IDs to connect with RELATED_TO
--active-task		on	Auto-link to the single active task (--no-active-task)
--surface		cli	Capture surface metadata
--wait-searchable		false	Wait until the memory is persisted and retrievable
--json	-j	false	Output as JSON
--raw		false	Store verbatim raw memory only
--diary		false	Store a private agent diary entry
--agent		(none)	Agent identity for diary entries
--source-id		(none)	Raw memory source ID
--scope		private	Raw memory scope
--scope-key		(none)	Project/team/shared scope key

Memory Kinds

remember defaults to episode, but the memory loop adds first-class kinds for durable reasoning artifacts:

Kind	Use Case
decision	A choice that was made, with rationale
plan	An intended sequence of work
idea	An exploration or proposal not yet acted on
claim	An assertion to be verified or cited later
artifact	A produced output (synthesis, doc, summary)
session	A session-level memory or summary
episode	General learning or knowledge (default)

See sibyl entity for the full entity type list.

Examples

Remember a Decision

sibyl remember "Use SurrealDB for the unified runtime" \
  "Chose SurrealDB over a Postgres+graph split. One store for graph, content, and auth removes sidecar drift and simplifies org isolation." \
  --kind decision

Remember a Plan

sibyl remember "Synthesis rollout plan" \
  "Ship plan/draft/verify behind a flag, dogfood on docs, then expose synthesis_* MCP tools." \
  --kind plan --domain synthesis

Remember from a File

sibyl remember "Incident 2026-05 postmortem" --content-file ./postmortem.md --kind episode

Store a Raw Memory

--raw skips graph extraction and stores the payload verbatim in the raw memory store. Raw memories are read back with recall --raw and reviewed before promotion.

sibyl remember "Deploy runbook" --raw --scope project --scope-key proj_abc123

Store an Agent Diary Entry

sibyl remember "Picked up the auth refactor" \
  "Started on token rotation. Blocker: Redis WRONGTYPE on refresh." \
  --diary --agent nova

Pipe Content from stdin

git log -5 --oneline | sibyl remember "Recent auth commits" --kind episode

Related Commands

• sibyl recall - Recall memory back into an agent context
• sibyl reflect - Turn raw notes into reviewable candidates
• sibyl capture - Quick capture without a separate title
• sibyl add - Add knowledge with explicit title and content
• Memory governance - Inspect, audit, and promote raw memory