nowledge-mem

name	nowledge-mem
description	Use Nowledge Mem in Alma for external memory, prior-thread recall, Context Bundle startup context, durable memory saves, and thread history lookup.

Nowledge Mem

Use Nowledge Mem as Alma's external memory system.

First Move

At the start of work that may depend on identity, active scope, Rules, recent priorities, or prior decisions, call nowledge_mem_context_bundle.

Use nowledge_mem_working_memory only when you need the lighter daily briefing or when Context Bundle is unavailable.

Retrieval

• Use nowledge_mem_query for broad recall across memories, with thread fallback.
• Use nowledge_mem_search for focused memory retrieval.
• Use nowledge_mem_thread_search when the user is asking about conversation history.
• When a memory includes sourceThreadId, use nowledge_mem_thread_show to inspect the original conversation before making strong claims.

Start with a narrow query. Fetch more pages only when the current result is not enough.

Saving

Use nowledge_mem_store when the conversation produces durable knowledge:

• decisions
• user preferences
• debugging conclusions
• workflow agreements
• plans that should survive the current chat
• facts about the user's projects or work

Choose unit_type deliberately: decision, learning, preference, fact, plan, procedure, context, or event.

Do not save pleasantries or filler. If the user explicitly asks you to remember something, save it.

Corrections And Cleanup

• Use nowledge_mem_update when a remembered item is wrong but should remain.
• Use nowledge_mem_delete only when the user clearly wants a memory removed.
• Use thread delete tools only on explicit user intent.

If Tools Are Hidden

If Alma does not expose plugin tools in the current thread, use Bash with nmem when available:

nmem --json context read --source-app alma
nmem --json m search "<query>" -n 5
nmem --json t search "<query>" -n 5 --source alma
nmem --json t show <thread_id> -n 30 --offset 0 --content-limit 1200
nmem --json m add "<content>" -t "<title>" --unit-type decision

If neither plugin tools nor Bash are available, state the blocker and ask for one concrete enablement step.

Response Contract

When memory affected the answer, include a short source line:

• Source: nowledge_mem_query
• Source: nowledge_mem_search + nowledge_mem_show
• Source: nowledge_mem_thread_search + nowledge_mem_thread_show
• Source: nmem CLI
• Source: injected recall context