🤖
Deepest Integration

Claude Code + MindMeld

Automatic standards injection directly into your Claude Code sessions. Your team's best practices, enforced on every prompt — zero manual effort.

1 Install the CLI

Install the MindMeld CLI globally. This gives you the mindmeld command across all your projects.

npm install -g @equilateral_ai/mindmeld

2 Log in

Authenticate with your MindMeld account. This opens your browser for secure Cognito authentication and stores a session token locally.

mindmeld login
Opening browser for authentication...
Authenticated as you@company.com

3 Initialize your project

Run mindmeld init in your project root. This analyzes your repository structure, detects your tech stack, and registers Claude Code hooks automatically.

cd ~/projects/your-repo
mindmeld init

Analyzing repository structure...
Detected: TypeScript, React, AWS SAM, PostgreSQL
Registered hooks:
session-start → injects relevant standards into CLAUDE.md
pre-compact → captures patterns before context compaction
Ready. Start a Claude Code session to see it in action.

4 Start coding

That's it. Every time you start a Claude Code session, MindMeld automatically injects the 8-10 most relevant standards based on what you're working on. When context is compacted, it captures any new patterns your team discovers.

# Just use Claude Code normally
claude

MindMeld: Injected 9 standards (serverless-saas, security, database-patterns)
Session ready.
Why CLI Hooks? This is the recommended method because everything is automatic. Standards are injected at session start without you asking, and new patterns are captured at compaction without any manual step. Your team's knowledge compounds over time with zero friction.

Switching Accounts

To switch between MindMeld accounts (e.g. personal vs work), log out and log back in:

mindmeld logout
Logged out successfully.

mindmeld login
Opening browser for authentication...
Authenticated as other@company.com

Use mindmeld status to check which account is currently active.

1 Create an API token

Go to your MindMeld dashboard and generate an API token. This token authenticates MCP requests from Claude Code to the MindMeld API.

# Visit the token management page
open https://app.mindmeld.dev/api-tokens

Click Create Token, give it a name (e.g., "Claude Code - laptop"), and copy the token value.

2 Configure MCP server

Add the MindMeld MCP server to your Claude Code settings. Open or create .claude/settings.json in your project root and add the following:

{ "mcpServers": { "mindmeld": { "type": "url", "url": "https://api.mindmeld.dev/api/mcp/mindmeld", "headers": { "X-MindMeld-Token": "YOUR_TOKEN_HERE" } } } }

Replace YOUR_TOKEN_HERE with the token you copied in Step 1.

3 Use MCP tools

With the MCP server configured, Claude Code gains two new tools you can invoke during your sessions:

# Initialize a session and get relevant standards
mindmeld_init_session
Loaded 8 standards for: serverless-saas, database-patterns, security

# Record a correction or pattern discovered during coding
mindmeld_record_correction
Pattern recorded: "Always use executeQuery wrapper for DB calls"

Call mindmeld_init_session at the start of each session to pull in your team's standards. Use mindmeld_record_correction whenever you discover a pattern worth preserving for the team.

MCP vs CLI Hooks: The MCP method gives you a lighter integration that works on-demand. You call the tools when you need them, rather than having hooks fire automatically. This is useful if you prefer explicit control, or if you work across machines where a global CLI install isn't practical.

What happens in each session

Whether you use CLI hooks or MCP, here is what MindMeld does behind the scenes:

# 1. Relevance scoring
MindMeld analyzes your project context — tech stack, recent files,
current branch — and scores each standard for relevance.

# 2. Compact injection (~400 tokens)
Only the top 8-10 standards are injected, compressed to ~400 tokens.
Small enough to leave your context window free for actual work.

# 3. Standards maturity lifecycle
New patterns start as "emerging" and graduate to "established" as
your team validates them. Stale standards decay automatically.
Your knowledge base stays current without manual curation.

Setup guides for other tools

MindMeld works with all major AI coding assistants.

Cline Cursor Windsurf Universal (any MCP client)