# memory

memory is a Claude Code skill that saves lasting facts to the appropriate memory file after a substantial exchange. It handles decisions, preferences, and project changes, while skipping one-off questions.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 285 repo stars
- Author: makushingu
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/makushingu/harness-maxxing/tree/HEAD/skills/memory/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/makushingu-memory

## What it does

memory chooses a storage level for each fact: agent, topic, project, or the whole workspace. It keeps brief notes on decisions, user preferences, work status, and reusable details such as paths or commands.

Keep notes short and replace facts that have changed rather than preserving conflicting versions. Longer material, such as test steps, can live in a nearby report with a path recorded in memory. Secrets must stay out of memory; record only the name of a key.

For Claude Code, run `npx skills add makushingu/harness-maxxing --skill memory -a claude-code`. The skill file is at `~/.claude/skills/memory/SKILL.md`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill memory -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/memory/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/memory/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill memory -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/memory/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill memory -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/memory/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install makushingu/harness-maxxing skills/memory
```

2. **Manually: put the files in place**
- File: `.github/skills/memory/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill memory -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/makushingu/harness-maxxing --path skills/memory
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/memory/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/makushingu/harness-maxxing/tree/HEAD/skills/memory/SKILL.md

## When to use it
- save a decision made during a discussion
- record a user's preference or working rule
- note a project's current state and next step
- keep a reusable path or command for later sessions

## Example prompts
- Record the decision to use `PostgreSQL` in the project memory.
- Save my rule that new tests belong next to the code.
- Note that the task is blocked until the API update.

## Similar
- [deep-agents-memory](https://affpapa.org/en/nevibecode/skills/deep-agents-memory.md) — skill · 20000 installs
- [memory-safety-patterns](https://affpapa.org/en/nevibecode/skills/memory-safety-patterns.md) — skill · 11746 installs
- [memory-management](https://affpapa.org/en/nevibecode/skills/memory-management.md) — skill · 7800 installs
- [memory-discipline](https://affpapa.org/en/nevibecode/skills/memory-discipline.md) — skill · 4900 installs
- [memory-leak-debugging](https://affpapa.org/en/nevibecode/skills/memory-leak-debugging.md) — skill · 3700 installs
- [trader-memory-core](https://affpapa.org/en/nevibecode/skills/trader-memory-core.md) — skill · 3700 installs

## Other versions with the same name
- [memory · yonatangross](https://affpapa.org/en/nevibecode/skills/orchestkit-memory.md) — 757 installs
- [memory · johnlindquist](https://affpapa.org/en/nevibecode/skills/johnlindquist-memory.md) — 363 installs
- [memory · plasma-ai](https://affpapa.org/en/nevibecode/skills/memory.md) — ★ 797 repo stars
- [memory · harperreed](https://affpapa.org/en/nevibecode/skills/harperreed-memory.md) — ★ 339 repo stars

From the same set: [makushingu/harness-maxxing](https://affpapa.org/en/nevibecode/by/makushingu/harness-maxxing.md) — 21 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
