clauder

README

Clauder

An MCP server that provides AI coding tools with persistent memory and multi-instance communication.

Supports: Claude Code, Cursor, Windsurf, OpenCode, OpenAI Codex CLI, and Google Gemini CLI.

Features

• Persistent Memory: Store facts, decisions, and context across Claude Code sessions
• Multi-Instance Communication: Discover and message other Claude Code instances running in different directories
• Automatic Context Injection: Load relevant context based on your working directory
• Web Dashboard: Visual interface to monitor instances, messages, and facts

Installation

Quick Install (Recommended)

macOS / Linux:

curl -sSL https://raw.githubusercontent.com/MaorBril/clauder/main/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/MaorBril/clauder/main/install.ps1 | iex

Installs to ~/.local/bin (Unix) or %LOCALAPPDATA%\clauder (Windows).

With Go

go install github.com/MaorBril/clauder@latest

Manual Download

Download the binary for your platform from Releases:

Platform	Binary
macOS (Apple Silicon)	clauder-darwin-arm64
macOS (Intel)	clauder-darwin-amd64
Linux (x64)	clauder-linux-amd64
Linux (ARM64)	clauder-linux-arm64
Windows (x64)	clauder-windows-amd64.exe

Build from Source

git clone https://github.com/MaorBril/clauder.git
cd clauder
make build

Setup

Claude Code

Run the setup command to configure Claude Code to use Clauder:

clauder setup

This will add the MCP server configuration to your Claude Code settings.

Cursor / Windsurf

For Cursor or Windsurf:

clauder setup --cursor
# or
clauder setup --windsurf

OpenCode

Clauder also works with OpenCode. Run:

clauder setup --opencode

This creates an opencode.json in your project directory with the MCP configuration.

OpenAI Codex CLI

For Codex CLI:

clauder setup --codex

This adds clauder to ~/.codex/config.toml.

Google Gemini CLI

For Gemini CLI:

clauder setup --gemini

This adds clauder to ~/.gemini/settings.json.

Usage

CLI Commands

# Store a fact
clauder remember "Project uses SQLite for persistence"

# Recall facts
clauder recall "database"

# List running instances
clauder instances

# Send a message to another instance
clauder send <instance-id> "Hello from another directory"

# Check messages
clauder messages

# View status
clauder status

# Launch web dashboard
clauder ui

Web Dashboard

Launch an interactive web dashboard to monitor all clauder activity:

clauder ui

This opens a browser to http://localhost:8765 with:

• Instances: View all running Claude Code sessions with status (active/idle/leader)
• Messages: Full message history with filtering by read/unread, sender, recipient
• Facts: Browse stored facts with filtering by tags, source directory, local/global

Options:

• -p, --port: Port to run on (default: 8765)
• -r, --refresh: Auto-refresh interval in seconds (default: 3)
• --no-browser: Don't automatically open browser

Keyboard shortcuts: 1/2/3 to switch views, R to refresh, Esc to close modals.

As MCP Server

Start the server (typically done automatically by Claude Code):

clauder serve

MCP Tools

When used as an MCP server, clauder provides these tools:

Tool	Description
remember	Store a fact, decision, or piece of context
recall	Search and retrieve stored facts
forget	Delete a stored fact (with confirmation)
get_context	Load all relevant context for the current directory
list_instances	List other running Claude Code sessions
send_message	Send a message to another instance
get_messages	Check for incoming messages

Data Storage

All data is stored in ~/.clauder/ directory using SQLite.

Telemetry

Clauder collects anonymous usage data to help improve the tool. This includes:

• OS and architecture
• Commands and features used (not content)
• Version information

No personal data, file contents, or facts are ever collected.

To opt out, set one of these environment variables:

export CLAUDER_NO_TELEMETRY=1
# or
export DO_NOT_TRACK=1

License

MIT License - see LICENSE for details.