Engram

Tools 27

10 only read, 14 change things, 3 can delete or overwrite. A ? marks an optional parameter.

mem_current_project

Report which project memories will go to and how it was resolveddirectory?: stringcwd?: string

mem_list_projects

List every known project with its counts

mem_context

Pull recent session history for the project, within a byte budgetproject?: stringscope?: stringmax_bytes?: numberolder_history?: booleancompact?: boolean

mem_search

Full-text search over saved observations, scoped to one project or allquery: stringtype?: stringproject?: stringall_projects?: booleanscope?: stringmatch_mode?: stringresponse_format?: stringlimit?: number

mem_search_prompts

Search stored user prompts, 10 results by defaultquery: stringproject?: stringall_projects?: booleanlimit?: number

mem_timeline

Show the observations recorded before and after a given oneobservation_id: numberbefore?: numberafter?: numberproject?: string

mem_get_observation

Fetch one observation in full, optionally with its edit historyid: numberinclude_history?: booleanhistory_cursor?: numberproject?: string

mem_save changes

Store a fix, decision, discovery or convention as an observationtitle: stringcontent?: stringobservation?: stringtype?: stringsession_id?: stringscope?: stringtopic_key?: stringproject?: stringproject_choice_reason?: stringrecovery_token?: stringcapture_prompt?: boolean

mem_update changes

Change fields of an existing observation by ID, or find and replace in its textid: numberexpected_project: stringtitle?: stringcontent?: stringfind?: stringreplace?: stringtype?: stringscope?: stringtopic_key?: string

mem_suggest_topic_key

Propose a stable topic key so a recurring subject updates one memorytype?: stringtitle?: stringcontent?: string

mem_consolidate deletes

Merge several observations into one new one, previewing first and deleting the sources only on confirmation

mem_capture_passive changes

Pull the items under a Key Learnings heading out of text and save each onecontent: stringsession_id?: stringsource?: string

mem_save_prompt changes

Keep the user's original request on recordcontent: stringsession_id?: stringproject?: stringproject_choice_reason?: stringrecovery_token?: string

mem_session_start changes

Register a new sessionid: stringdirectory?: string

mem_session_summary changes

Store an end-of-session handoff: goal, findings, next steps, filescontent: stringsession_id?: stringproject?: stringproject_choice_reason?: stringrecovery_token?: string

mem_session_end changes

Mark a session as finishedid: stringsummary?: string

mem_session_finalize changes

Save a summary and close an already registered session in one transaction

mem_pin changes

Pin an observation so it comes first in context (local to the device, not synced)id: number

mem_unpin changes

Remove a pinid: number

mem_review changes

List observations past their review date, or mark one as reviewedaction: stringproject?: stringlimit?: numberobservation_id?: numberid?: number

mem_judge changes

Settle a pending conflict between two memories with a relation and reasonjudgment_id: stringrelation: stringreason?: stringevidence?: stringconfidence?: numbersession_id?: string

mem_judge_many changes

Apply 1 to 32 judgments in order in one call; each stands or fails alonejudgments: arraysession_id?: string

mem_compare changes

Record a verdict on how two memories relate, with confidence and reasoningmemory_id_a: numbermemory_id_b: numberrelation: stringconfidence: numberreasoning: stringmodel?: string

mem_doctor

Run read-only checks on project and store healthproject?: stringcheck?: string

mem_stats

Count sessions, observations, prompts and projectsproject?: string

mem_delete deletes

Delete an observation by ID: soft delete unless hard_delete is trueid: numberexpected_project: stringhard_delete?: boolean

mem_merge_projects deletes

Fold project name variants into one canonical project namefrom: stringto: string