/remember

name: remember
description: Use when the user wants to persistently remember something across sessions (e.g., "always use bun", "never auto-commit", "my name is Alex"). Also use when you detect a clear user preference or constraint worth persisting.

remember

Overview

Saves a user preference, constraint, or fact to REMEMBER.md so it persists across sessions. The user chooses scope (global or project).

When to Use

• User explicitly says "remember...", "always...", "never...", "don't forget..."
• User states a clear preference or constraint worth persisting (e.g., "I use bun not npm")
• User provides identity or context info they'd want every session to know

Instructions

1. Distill what the user wants to remember into **one concise line** (imperative form, no filler).

• Good: "Use bun instead of npm for all package management"
• Bad: "The user mentioned they prefer bun over npm and would like us to always use it"

2. Ask the user which scope using AskUserQuestion:

Which scope should this apply to?
- Global: applies to all projects
- Project: applies only to this project

3. Get the **plugin scripts path** from the SessionStart injection in your context: `Plugin scripts path: /path/to/scripts`

4. Run the remember script:

bash "<plugin_scripts_path>/remember.sh" "<scope>" "<content>"

Where:

• `plugin_scripts_path`: the path from SessionStart injection
• `scope`: `global` or `project`
• `content`: the distilled one-liner (quote it properly for shell)

Rules

• One entry per invocation — don't batch multiple items
• Distill to a clear imperative statement, not a description of what happened
• If the user's intent is ambiguous, ask for clarification before writing
• Do NOT remember session-specific or temporary information (e.g., "I'm debugging auth today")

Examples

| User says | Distilled entry | |---|---| | "Remember I always use bun" | `Use bun instead of npm for package management` | | "Never auto-commit without asking" | `Never auto-commit; always ask before committing` | | "My name is Alex" | `User's name is Alex` | | "For this project, always run tests with --verbose" | `Run tests with --verbose flag` (project scope) |