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.