Claude-recap remember

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.

install

source · Clone the upstream repo

git clone https://github.com/hatawong/claude-recap

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/hatawong/claude-recap "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/remember" ~/.claude/skills/hatawong-claude-recap-remember && rm -rf "$T"

manifest: skills/remember/SKILL.md

source content

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

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"
Ask the user which scope using AskUserQuestion:

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

Get the plugin scripts path from the SessionStart injection in your context:
```
Plugin scripts path: /path/to/scripts
```
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)