Broca for Claude Desktop banner
Bande-a-Bonnot Bande-a-Bonnot

Broca for Claude Desktop

Development community intermediate

Description

Add persistent file-based memory to Claude Desktop in 5 minutes.

Installation

Terminal
claude install-skill https://github.com/Bande-a-Bonnot/Boucle-framework

README

Broca for Claude Desktop

Add persistent file-based memory to Claude Desktop in 5 minutes.

What is Broca?

Broca is a file-based memory system for AI agents. Instead of losing context between conversations, Claude can remember facts, decisions, and insights across sessions. Your memories are stored as readable Markdown files that you can edit, version with git, and backup anywhere.

Features

    undefined

Quick Setup

Automated Installation (Recommended)

# Download and run the installer
curl -fsSL https://raw.githubusercontent.com/Bande-a-Bonnot/Boucle-framework/main/install-broca.sh | bash

The installer will:

    undefined

**Manual Installation** (if you prefer building yourself):

# Install Rust if needed
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env

# Build Boucle framework
git clone https://github.com/Bande-a-Bonnot/Boucle-framework.git
cd Boucle-framework
cargo build --release

# Install to local bin (no sudo needed)
mkdir -p ~/.local/bin
cp target/release/boucle ~/.local/bin/
export PATH="$HOME/.local/bin:$PATH"

Manual Setup (only if you didn't use the automated installer)

If you used the automated installer above, **skip to "Usage Examples"** below — everything is configured for you!

2. Initialize Memory

# Create a memory directory
mkdir ~/claude-memory
cd ~/claude-memory

# Initialize Broca
boucle init --name claude-memory

3. Configure Claude Desktop

Add this to your Claude Desktop MCP configuration:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`

{
  "mcpServers": {
    "broca": {
      "command": "boucle",
      "args": ["mcp", "--stdio"],
      "cwd": "~/claude-memory"
    }
  }
}

Restart Claude Desktop

Close and reopen Claude Desktop. You should now have Broca memory tools available.

**Note**: If you used the automated installer, this restart was the only step required — memory directory and Claude configuration were set up automatically!

Usage Examples

Basic Memory Operations

Remember this: I prefer TypeScript over JavaScript for larger projects
Tags: preferences, programming, javascript, typescript
Search for: programming preferences

Project Memory

Remember: Project X uses PostgreSQL database with connection pool of 20
Tags: project-x, database, postgresql
Recall: How many connections in Project X database?

Decision Tracki