napkin
View on GitHubA Claude Code skill that gives the agent persistent memory of its mistakes via a per-repo markdown scratchpad.
Napkin is a Claude Code (and Codex) skill that keeps a per-repo markdown scratchpad at .claude/napkin.md, where the agent records its mistakes, your corrections, and preferences each session and reads them back at start. It gives coding agents lightweight persistent memory so recurring errors drop off after a few sessi
Use Cases
Give coding agents memory of past mistakes across sessionsLog user corrections and preferences per repositoryReduce repeated agent errors on long-lived projectsShare learned repo patterns with teammates by committing the napkin fileImprove coding agent behavior over multiple sessionsTrack tool and environment surprises in a repo
Built With
- Frameworks
- Claude Code · Codex
Tags
claude-code · agent-memory · persistent-memory · prompt-skill · skill · markdown · continual-learning · codex · developer-workflow · context-management · self-improvement · agent-scratchpad