recall

Recall a compact working context pack for an agent. recall is the read side of the Sibyl memory loop. Given a goal, it compiles the most relevant tasks, decisions, plans, and graph neighbors into a single pack an agent can drop into context.

Synopsis

sibyl recall <goal> [options]

Arguments

Argument	Required	Description
goal	Yes	Agent goal or user task

Options

Option	Short	Default	Description
--intent	-i	build	Agent intent (see below)
--layer		recall	Context depth: wake, recall, deep_search
--domain	-d	(none)	Domain/category to bias retrieval
--project	-p	(auto)	Project ID
--agent		(none)	Agent diary identity to include
--all	-a	false	Use all accessible projects
--limit	-l	12	Maximum context items (1-50)
--related		on	Include one-hop related graph context (--no-related)
--json	-j	false	Output full JSON
--raw		false	Recall verbatim raw memories
--diary		false	Recall a private agent diary
--scope		private	Raw memory scope
--scope-key		(none)	Project/team/shared scope key

Intent

The --intent flag biases what kind of memory the pack favors:

Intent	Bias
build	Implementation patterns and active tasks
plan	Decisions, plans, roadmap context
ideate	Ideas, open questions, prior exploration
research	Claims, sources, documents
review	Recent changes, prior review notes
debug	Error patterns, gotchas, related failures
decide	Decisions, constraints, tradeoffs
learn	Guides, procedures, durable knowledge
general	Balanced mix

Layers

--layer controls how deep the recall reaches:

Layer	Behavior
wake	Fast startup pack: active tasks and a few high-signal memories
recall	Default working pack scoped to the goal
deep_search	Wider semantic sweep across the graph

Examples

Working Context Pack

sibyl recall "wire up the password reset endpoint"

Debug Intent

sibyl recall "auth token refresh fails intermittently" --intent debug

Deep Search

sibyl recall "how synthesis verification works" --layer deep_search --limit 25

Recall Raw Memories

By default recall returns graph-extracted entities. Use --raw to pull verbatim raw memory sources captured with remember --raw:

sibyl recall "deployment runbook" --raw --scope project

Recall an Agent Diary

sibyl recall "what nova was working on" --diary --agent nova

JSON for Agent Injection

sibyl recall "implement OAuth2" --json | jq '.items[].title'

Related Commands

• sibyl remember - Capture durable memory (the write side)
• sibyl reflect - Turn raw notes into memory candidates
• sibyl context pack - Lower-level context compilation
• sibyl session - Wake-up bundle for a new session