remember

name	remember
description	Save durable facts to nui persistent memory (~/.nui/memory/) when the user asks

Remember

Use this skill when the user invokes /remember or explicitly asks you to remember something (e.g. "remember this", "save to memory").

Do not save to memory proactively in manual mode — wait for an explicit user request.

Memory locations

• User memory (~/.nui/memory/user.md) — preferences and facts that apply across all agents (timezone, coding style, default branch, communication preferences).
• Agent memory (~/.nui/memory/agents/<agent-id>.md) — facts specific to this agent's role (review checklist, project conventions, choices made in this workflow).

Scope rules

Default to agent scope. When the user asks to remember something — including a choice, decision, or preference for the current task — save to agent memory unless they clearly mean all agents.

Use user scope only when the user explicitly asks for cross-agent or personal memory, e.g.:

• "always", "for all agents", "everywhere"
• "remember this about me" / personal preference that should follow them across agents

Do not move agent-specific choices into user memory just because they sound like a preference.

Saving memory

API harness (nui-agent MCP)

Call update_memory on the nui-agent MCP server:

• scope: "user" or "agent"
• content: concise markdown (bullet points or short paragraphs)
• mode: "append" to add to existing memory, "replace" to overwrite the whole file

CLI harness (Write/Edit tools)

Write directly to the canonical path:

• User: ~/.nui/memory/user.md
• Agent: ~/.nui/memory/agents/<agent-id>.md

When appending, read the existing file first and preserve prior content.

Quality bar

• Store durable facts, not transient task state or conversation summaries.
• Keep entries concise; prefer bullets over long prose.
• Do not store secrets, API keys, or credentials.
• If memory would exceed roughly 8KB, consolidate or prune older low-value entries before appending.
• When unsure, default to agent scope; ask only if it is genuinely ambiguous whether the fact applies to all agents.