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

# recall

> Start here — the session brief, search, file history, your position on the map, and the triage session

Your persistent memory across all AI tools. The mode is chosen by which parameters you pass; with **no parameters** it returns the **session brief** — what an agent needs in the first call of a session.

## Modes

### Session brief (no parameters)

```json theme={null}
{}
```

```json theme={null}
{
  "brief": true,
  "triage": "46 anchors: 🔴 2 drifting · 🟡 1 needs review · 🔵 8 verified · ⚫ 35 unverified",
  "attention": [{ "id": 26, "state": "drift", "statement": "…", "reality": "…" }],
  "where": { "project": "linksee-memory", "you_are_here": "You are at \"readme\" in stage 「理解」. Touching it implicates 3 node(s): lp, docs, skill." },
  "open_loops": { "north_star": { "id": 67, "statement": "…" }, "proposals": 0, "proposals_top": [], "distill_queue": 250, "friction": 4 },
  "entities": [{ "name": "KanseiLINK", "kind": "project", "memories": 812 }],
  "next": [
    "recall({ query }) to search; recall({ path }) for a file's history",
    "drift_status() for the full truth map; drift_status({ anchor_id }) for one decision",
    "recall({ dream: true }) to triage proposals and drain the distill queue",
    "remember({ content, anchor: {} }) to record a decision and enforce it"
  ]
}
```

Attention items in full; everything else as counts plus the exact next calls. Small enough to call freely. `overview: true` returns the old entity list instead.

### Search (`query`)

```json theme={null}
{ "query": "Supabase connection pooling", "layer": "caveat" }
```

Memories ranked by relevance, heat, momentum and importance. FTS5 with a trigram tokenizer, so Japanese and English both work. Filters: `entity_name`, `layer`, `altitude`, `mem_type`, `mem_state`, `band`, `thread_id`. Ranking internals (`heat`, `band`, `composite`, `match_reasons`, `score_breakdown`) are included only with `explain: true` — they roughly double the cost per memory.

### File history (`path`)

```json theme={null}
{ "path": "src/db/connection.ts" }
```

Every recorded edit to the file, each with the **user message that drove it**. Add `scope_to_roots: true` to filter to the workspace.

### Locate on the map (`where`)

```json theme={null}
{ "where": "guard hook re-injection" }
```

or `{ "where": true }` to auto-locate from the files you edited recently. Returns your node, journey stage, the **blast radius** (what else moves if you touch this) and the decision behind it. Pass `project` when several maps are imported. (Absorbs the old `where_am_i`.)

### Triage session (`dream: true`)

```json theme={null}
{ "dream": true, "distill": 10 }
```

The full set: the North Star, orphaned proposals (each with `candidate_id`), the **distill queue** of raw auto-captured memories to rewrite, and friction (anchors re-surfaced at the gate yet still violated). Resolve proposals with [`resolve_drift({ candidate_id, action })`](/tools/resolve-drift); rewrite distill items with [`remember({ memory_id, content })`](/tools/remember). (Absorbs the old `dream`.)

The distill queue is value-ordered — caveats first, then memories on a named entity, then longer text — and rules have already settled the obvious: acknowledgements, bare paths and 90-day-old never-recalled items carry a `distill_verdict` and are not shown. `distill_total` is the real remainder; `distill` (max 25) is the page size.

## Parameters

| Name                                                                                   | Type             | Description                                                        |
| -------------------------------------------------------------------------------------- | ---------------- | ------------------------------------------------------------------ |
| `query`                                                                                | string           | Search. Keywords, entity names, or FTS5 expressions.               |
| `path`                                                                                 | string           | File history mode.                                                 |
| `where`                                                                                | string · boolean | Locate on the Current Truth Map.                                   |
| `dream`                                                                                | boolean          | The triage session.                                                |
| `distill`                                                                              | number           | With `dream`: page size for the distill queue (default 8, max 25). |
| `overview`                                                                             | boolean          | Entity list instead of the brief.                                  |
| `explain`                                                                              | boolean          | Include ranking internals in search results.                       |
| `entity_name` · `layer` · `altitude` · `mem_type` · `mem_state` · `band` · `thread_id` | —                | Search filters.                                                    |
| `limit` · `offset` · `max_tokens`                                                      | —                | Pagination and token budget (default 2000).                        |
| `project`                                                                              | string           | With `where`: the map project slug.                                |
| `mark_accessed`                                                                        | boolean          | `false` for preview queries.                                       |

## When to call

* **First call of every session** — no arguments
* Before starting any task or touching a file
* When the user says "before" / 「前に」 / "last time" / "remember when"
* When an error occurs — have you seen it before?
* Before a decision — is there a prior decision on this topic?