Brain

Overview

Command	Description	Cost
`naive brain query <question>`	Grounded answer + citations	10 credits
`naive brain recall <query>`	Recall structured semantic memory	Free
`naive brain remember <fact>`	Write a durable semantic memory episode	Free
`naive brain think <query>`	Synthesize memory + docs with gap notes	10 credits
`naive brain graph`	Explore the entity/relation knowledge graph	Free
`naive brain timeline`	Memory events/facts in chronological order	Free
`naive brain forget <scope> <ref>`	Tombstone/forget a memory scope	Free
`naive brain add`	Ingest a document (`--file`/`--text`/`--url`)	5 credits
`naive brain note <fact>`	Ingest a short fact as a document	5 credits
`naive brain replace-doc <id>`	Replace/refresh a document in place	5 credits
`naive brain docs`	List ingested documents + status	Free
`naive brain doc <id>`	Get one document (refreshed status)	Free
`naive brain rm-doc <id>`	Delete a document (permanent)	Free
`naive brain list`	List knowledge bases	Free
`naive brain create`	Create a knowledge base	Free
`naive brain rm <id>`	Delete a knowledge base (permanent)	Free

note vs remember

remember writes a durable semantic memory episode — facts/entities/claims are extracted and become recallable via recall/think/graph/timeline. note (and add) ingest text as a document — chunked and embedded, answerable via query. Use remember for durable facts, note/add for source material.

Ingest + query

naive brain add --file ./handbook.pdf
naive brain add --text "Our refund policy is 30 days" --source policy
naive brain add --url https://example.com/pricing

naive brain docs                       # confirm status: ready
naive brain query "What is our refund policy?"
naive brain query "And for enterprise?" --session <session_id>

--file, --text, --url are mutually exclusive (provide exactly one). --kb <id> targets a specific knowledge base.

Semantic memory

naive brain remember "Acme Corp prefers quarterly invoicing" --source crm --confidence 0.9
naive brain recall "Acme invoicing" --entity "Acme Corp" --limit 10
naive brain think "How should we bill Acme?" --session <session_id>
naive brain graph --entity "Acme Corp"
naive brain timeline --entity "Acme Corp" --limit 20

Forget (right-to-be-forgotten)

naive brain forget entity "Acme Corp" --reason "customer erasure request"
naive brain forget document <doc_id>

For agent (API-key) callers, forget, rm-doc, and rm are approval-gated — the CLI surfaces a pending-approval result an owner must approve.

Knowledge bases

naive brain list
naive brain create --name "Engineering Docs"
naive brain create --name "Default" --default
naive brain rm <kb_id>

CLI Reference

Multi-tenant

Primitives

Overview

note vs remember

Ingest + query

Semantic memory

Forget (right-to-be-forgotten)

Knowledge bases

​Overview

​note vs remember

​Ingest + query

​Semantic memory

​Forget (right-to-be-forgotten)

​Knowledge bases

Overview

note vs remember

Ingest + query

Semantic memory

Forget (right-to-be-forgotten)

Knowledge bases