recall - Linksee Memory

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)

{}

{
  "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`)

{ "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`)

{ "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`)

{ "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`)

{ "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 }); rewrite distill items with remember({ memory_id, content }). (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?

​Modes

​Session brief (no parameters)

​Search (query)

​File history (path)

​Locate on the map (where)

​Triage session (dream: true)

​Parameters

​When to call