Claude Diary

Claude Diary

A long-term memory plugin for Claude Code that learns from your activity over time and continuously improves Claude's understanding of your preferences, patterns, and workflows.

- Diary: Generate a diary entry for any Claude Code session
- Reflection: Performs reflection across multiple diary entries
- Memory: Reflection updates your CLAUDE.md with observed patterns and preferences

Read more: Blog post

Quickstart

1. Clone this repository:

2. Install commands:

3. Install PreCompact hook (for auto-diary generation):

4. Configure the hook in settings:

   Add the following to ~/.claude/settings.json (global) or .claude/settings.local.json (project-specific):

   Alternatively, use the interactive command:

   Then select PreCompact event, auto matcher, and enter bash ~/.claude/hooks/pre-compact.sh as the command.

5. Use the system:
   - Run /diary after important sessions (or let the PreCompact hook auto-generate)
   - After any collection of diary entries, run /reflect to analyze patterns
   - CLAUDE.md automatically updated with learnings

Overview

CLAUDE.md files serve as long-term memory for Claude Code. But, they are typically updated manually (e.g., via the # shortcut or /memory command). This plugin aims to automates the process of updating CLAUDE.md with the learnings from your activity over time. It is inspired by an interview between Dan Shipper and Cat Wu / Boris Cherny from the Claude Code team, which mentions that some Anthropic employees have started generating diary entries for Claude sessions and performing reflection over them. The approach follows that general flow, and also borrows ideas from the Generative Agents paper, which introduces a memory architecture with three key components:

1. Observations: Raw experiences recorded in…