remember - Linksee Memory

Save, update, or delete memories that persist across sessions and across AI agents. This is the unified write tool — it handles create, update, and delete operations based on which parameters you provide. Memories saved here are accessible from any AI agent the user connects to — Claude, GPT, Cursor, Codex, Gemini.

v0.7.0: remember replaces the previous remember + update_memory + forget tools. Mode is auto-detected from params.

Modes

Create (default)

Provide entity_name + entity_kind + layer + content:

{
  "entity_name": "KanseiLink",
  "entity_kind": "project",
  "layer": "caveat",
  "content": "{\"title\":\"freee OAuth Friday deploy\",\"what\":\"Never deploy freee OAuth changes on Friday\",\"why\":\"Their sandbox goes down for maintenance every Friday night JST\"}",
  "importance": 0.95
}

Update

Provide memory_id + fields to change:

{
  "memory_id": 42,
  "content": "Updated caveat: verified again 2026-05, still applies",
  "importance": 0.95
}

Preserves memory_id and session_file_edits links. Preferred over delete + create.

Delete

Set forget: true + memory_id:

{
  "forget": true,
  "memory_id": 42
}

Caveat-layer and pinned memories (importance >= 0.9) are protected and cannot be deleted.

Parameters

Create mode (required)

string

required

Name of the entity this memory is about (e.g. “MyProject”, “Supabase”, “Alice”).

string

required

One of: person, company, project, concept, file, other.

string

required

Memory layer. One of: goal, context, emotion, implementation, caveat, learning.Common aliases are accepted:

Alias	Resolves to
`why`, `intent`, `targets`	`goal`
`background`, `reason`, `timing`	`context`
`tone`, `feelings`, `mood`	`emotion`
`impl`, `how`, `tried`	`implementation`
`warning`, `pain`, `pitfall`, `dont`	`caveat`
`decision`, `insight`, `growth`	`learning`

string

required

The memory content. Plain text or JSON with structured axes (title, altitude, type, state, what, why, affects, next_action).

Optional (all modes)

number

0.0 to 1.0. Set to 0.9 or higher to pin a memory — pinned memories are protected from auto-forgetting even outside the caveat layer. Default: auto-assigned based on layer.

string

Optional thread ID to group related memories (e.g. a session ID or decision chain). Enables decision -> implementation -> outcome tracing.

boolean

default:"false"

Bypass the paste-back quality check. Set true only when you are sure the content is original user or agent thought, not pasted CI logs or assistant output.

Update mode

number

The memory.id to update. Get this from a prior recall response. When provided without forget: true, enters update mode.

Delete mode

boolean

default:"false"

Set true with a memory_id to delete that memory.

Behavior

Entity resolution: 3-tier matching — canonical_key exact -> normalized_name -> case-insensitive name -> insert new entity
Quality check: Rejects pasted CI logs, assistant output, and other non-original content (bypass with force: true)
Auto-structuring: Plain text is wrapped into structured JSON with inferred altitude, type, and state classifications
Pinning: Memories with importance >= 0.9 get protected = 1, preventing auto-forgetting
Events: Records a memory_stored event for momentum tracking

Caveat-layer memories are always protected regardless of importance score. They survive consolidation and auto-forgetting indefinitely.

Migration from pre-v0.7

Old call	New equivalent
`update_memory({ memory_id: 42, content: "..." })`	`remember({ memory_id: 42, content: "..." })`
`forget({ memory_id: 42 })`	`remember({ forget: true, memory_id: 42 })`
`forget({ dry_run: true })`	No longer exposed — auto-consolidation handles cleanup on startup

​Modes

​Create (default)

​Update

​Delete

​Parameters

​Create mode (required)

​Optional (all modes)

​Update mode

​Delete mode

​Behavior

​Migration from pre-v0.7

Modes

Create (default)

Update

Delete

Parameters

Create mode (required)

Optional (all modes)

Update mode

Delete mode

Behavior

Migration from pre-v0.7