> ## Documentation Index
> Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Brain

> Company knowledge base + memory from the CLI — ingest docs, ask grounded questions, and manage semantic memory.

## 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

```bash theme={"theme":"css-variables"}
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

```bash theme={"theme":"css-variables"}
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)

```bash theme={"theme":"css-variables"}
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

```bash theme={"theme":"css-variables"}
naive brain list
naive brain create --name "Engineering Docs"
naive brain create --name "Default" --default
naive brain rm <kb_id>
```