Pensieve Plugin for Claude Code

What is this?

The Pensieve plugin integrates Pensieve with Claude Code, enabling your AI agent to automatically search and recall relevant memories from past sessions.

When Claude starts a new session in your project, it automatically searches for relevant context, patterns, and solutions you've recorded previously - preventing repeated mistakes and building on past learnings.

Quick Start

Prerequisites

First, ensure Pensieve CLI is installed:

# Install via Homebrew (macOS)
brew tap cittamaya/pensieve
brew install pensieve

# Verify installation
pensieve --version

See installation guide for other platforms.

Option 1: Interactive Installation (Recommended)

In any Claude Code session, type:

/plugin

This opens an interactive menu where you can:

1. Add the Cittamaya marketplace (if not already added)
2. Browse and install the Pensieve plugin
3. Manage installed plugins

Option 2: CLI Installation

Step 1: Add Cittamaya Marketplace (if not already added)

claude plugin marketplace add https://github.com/cittamaya/cittamaya.git

Step 2: Install Pensieve Plugin

# Install plugin (auto-detects from available marketplaces)
claude plugin install pensieve

# Or specify the marketplace explicitly
claude plugin install pensieve@cittamaya-marketplace

That's It!

Once installed, Pensieve automatically:

• ✅ Hooks into session start - searches for relevant memories automatically
• ✅ Makes the memory-management skill available
• ✅ Responds to natural language like "remember this" or "recall that pattern"

No initialization needed - just start a new Claude Code session and the plugin is active!

Features

See It In Action

Check out the interactive demos showing Pensieve working with Claude Code across multiple sessions:

• Session 1: Discovering date parsing ambiguity bug
• Session 2: Automatic recall prevents repeating the mistake
• Session 3: Pattern recognition across all sessions

Watch how Claude automatically finds relevant memories, evaluates learnings against rubric criteria, and builds knowledge graphs - all without explicit prompting.

Documentation

For complete documentation on using Pensieve:

• Pensieve Documentation - Complete CLI reference
• Command Reference - All CLI commands
• Why Pensieve? - Learn about contextual scratchpad memory

How It Works

The plugin provides three ways to interact with Pensieve:

1. Automatic (Recommended)

The memory-management skill automatically activates when you use memory-related words in conversation:

• "Remember this pattern for future sessions"
• "Recall what we learned about date parsing"
• "Note that this approach works best"
• "Don't forget this workaround"

Claude automatically searches pensieve and records learnings based on context.

2. Explicit Slash Commands

For direct control:

/pensieve:remember  # Record current context to pensieve
/pensieve:recall    # Search pensieve for relevant memories

3. Session Hooks

Automatic memory search runs at the start of each session in your project, surfacing relevant past learnings before you even ask.

Contributing

This plugin is part of the Cittamaya organization's collection of agentic tools.

Found a bug or have a feature request? Open an issue on GitHub.