Skip to main content
CORE transforms Claude Code into a persistent memory agent that remembers your preferences, past decisions, and project context across all sessions.

​
Prerequisites

​
Installation

The CORE Brain plugin automatically handles memory integration for you. Step 1: Install CORE CLI 
npm install -g @redplanethq/corebrain
Step 2: Add Plugin Marketplace and Install Open Claude Code and run: 
/plugin marketplace add redplanethq/core
/plugin install core_brain
Step 3: Restart and Authenticate 
# Restart Claude Code, then authenticate:
/mcp
# Select core_brain from the list and authenticate via browser
That’s it! CORE is now automatically integrated with your Claude Code sessions.

​
How It Works

​
Automatic Persona Loading

When you start a Claude Code session, the plugin automatically:
  1. Fetches your persona document - A comprehensive summary of your preferences, rules, decisions, and patterns extracted from all your past conversations
  2. Injects it into Claude’s context - Claude always has your personalized context available without you needing to repeat yourself
  3. Enables memory search - Claude can search your entire knowledge graph for relevant context
Example: If your persona includes “Prefers concise code reviews with actionable feedback” and “Always runs tests before commits”, Claude will follow these rules automatically in every session.

​
SessionStart Hook

On every session start (startup, clear, or compact), the plugin:
  • Authenticates with CORE using your stored credentials
  • Fetches your latest persona document
  • Provides guided memory search instructions to Claude
  • Exports your CORE auth token to the session environment

​
Stop Hook (Memory Ingestion)

When you end a session, the plugin:
  • Extracts conversation pairs from the session transcript
  • Tracks what’s already been ingested to avoid duplicates
  • Queues new conversations for ingestion into your knowledge graph

​
Features

​
1. Persistent Memory Across Sessions

Your persona document is auto-generated from all your conversations and includes:
  • Preferences: Coding style, tools, patterns you prefer
  • Decisions: Past architectural choices and their reasoning
  • Directives: Hard rules like “always run tests” or “never skip code review”
  • Knowledge: Technologies and concepts you’re familiar with
  • Goals: What you’re working toward
  • Identity: Your role, company, expertise level

​
2. Memory Search Tool

Claude automatically searches your memory when:
  • You mention “previously”, “before”, “last time”
  • Working on a project with history
  • You reference past decisions or discussions
  • Starting work on features that might have context
The plugin provides intelligent search patterns:
  • Entity-Centric: “User’s preferences for API design and error handling”
  • Multi-Entity Relationship: “Manoj and Harshith discussions about BFS search implementation”
  • Semantic Questions: “What causes BFS search to return empty results?”
  • Temporal: “Recent changes to search implementation and reranking logic”

​
3. Integration Actions

Execute actions in your connected apps directly from Claude Code:
  • Create/read GitHub and Linear issues
  • Draft/send/read emails
  • Manage calendar events
  • Update spreadsheets

​
Available Tools

The plugin exposes these MCP tools to Claude:
  • memory_search: Search your knowledge graph for relevant context
  • get_integrations: List your connected integrations (GitHub, Linear, Slack, etc.)
  • get_integration_actions: Discover available actions for an integration
  • execute_integration_action: Perform actions in connected apps

​
Verify Connection

Test that everything works: 
# In Claude Code:
Search my memory for recent discussions about authentication

# Claude will automatically use the memory_search tool
You should see results from your past conversations.

​
Method 2: Manual MCP Setup (Advanced)

For users who need manual control or custom configuration: Step 1: Install the CORE MCP Server 
claude mcp add --transport http --scope user core-memory https://mcp.getcore.me/api/v1/mcp?source=Claude-Code
Step 2: Authenticate
  1. Type /mcp in Claude Code
  2. Select core-memory from the list
  3. Authenticate via your browser
Step 3: Configure Custom Agents (Optional) Create .claude/agents/ directory and add custom memory search/ingest agents if needed. See the advanced configuration guide for details.

​
What Makes This Different

Traditional RAG: “What text chunks look similar to this query?” CORE Memory Agent: “What does the user want to know, and where in their organized knowledge does that live?” CORE doesn’t just search text—it understands intent, classifies queries, and retrieves exactly what matters. Your preferences from 3 months ago, the decision you made last week, the problem you solved yesterday—all connected and surfaced at the right time.

​
Troubleshooting

Plugin Installation Issues:
  • Ensure Node.js 18+ is installed: node --version
  • If npm install -g @redplanethq/corebrain fails, try with sudo: sudo npm install -g @redplanethq/corebrain
  • After plugin installation, always restart Claude Code before authenticating
Authentication Issues:
  • Run corebrain me to check authentication status
  • If not authenticated, run corebrain login manually
  • Ensure you’re logged into your CORE account in the browser
  • Restart Claude Code if authentication seems stuck
Memory Search Not Working:
  • Verify plugin is installed: /plugin list should show core_brain
  • Check MCP connection: /mcp should show core_brain as Connected
  • Try manual memory search: “Search my memory for recent work”
Persona Not Loading:
  • The persona is automatically fetched on session start
  • If missing, check the SessionStart hook output in Claude Code logs
  • Verify your CORE account has stored conversations

​
Learn More