Memory Guide

---
name: nowledge-mem-guide
description: >
  Cross-AI personal knowledge graph memory (Nowledge Mem). Stores memories from this tool,
  Claude Code, Cursor, browser capture, imported documents, and more. Use when: (1) the user
  asks about prior work, decisions, preferences, people, dates, plans, or todos, (2) the user
  references something discussed before or says "remind me" / "what did we decide" / "what was
  I working on", (3) the conversation produces a decision, preference, plan, or learning worth
  keeping, (4) the user wants to browse recent activity or explore how ideas connect, (5) the
  user asks about a past conversation or wants to find a specific thread.
---

# Nowledge Mem

## Search (memory_search)

Use natural language queries. This is semantic search, not file search.

- "database choice for task events" (not "MEMORY.md" or file paths)
- "meeting with Sarah about API redesign"
- "deployment procedure for production"

Results include `matchedVia` (scoring breakdown), `importance`, `labels`, `sourceThreadId`.

When results include `relatedThreads`, use `nowledge_mem_thread_fetch` with the `threadId` for full conversation context. Start with a small page; fetch more via `offset` + `limit` only when needed.

Bi-temporal filters narrow results by time:

- `event_date_from` / `event_date_to` — when the fact happened
- `recorded_date_from` / `recorded_date_to` — when it was saved

## Save (nowledge_mem_save)

Save proactively when the conversation produces a durable fact, preference, decision, plan, procedure, learning, event, or important context. Do not wait to be asked.

Structure saves:

- `unit_type`: fact | preference | decision | plan | procedure | learning | context | event
- `labels`: lowercase-hyphenated topic tags
- `importance`: 0.0-1.0 (most: 0.5; key decisions/preferences: 0.7-0.9)
- `event_start` / `event_end`: ISO dates when temporal

Skip trivial exchanges, greetings, and meta-conversation about memory itself.

## Connections (nowledge_mem_connections)

Pass a `memoryId` from search results to explore related memories, evolution chains, and source documents. Edge types: EVOLVES, CRYSTALLIZED_FROM, SOURCED_FROM, MENTIONS.

## Timeline (nowledge_mem_timeline)

Browse recent activity grouped by day. Filter by `event_type` or exact `date_from` / `date_to` range.

## Threads (nowledge_mem_thread_search + nowledge_mem_thread_fetch)

Find past conversations by keyword, then progressively fetch messages. Threads span all sources: this tool, other AI tools, browser capture, imports.

## Startup Context (nowledge_mem_context)

Read Context Bundle when identity, active space, active rules, or current priorities matter. Older `nmem` clients fall back to the user's Working Memory briefing. Patch a specific Working Memory section with `patch_section` + `patch_content`/`patch_append` when the conversation updates a priority or resolves a flag.

## Important

- Search uses natural language queries, not file paths. Never search for "MEMORY.md" or "memory/*.md".
- When `relatedThreads` appear in results, they often contain the most useful context.
- Use tools directly; do not tell the user to "check your memory."