English Français العربية

LBrain

Official registry AI and agents

Local-first agent memory. Source, date, bind/abstain. Permanent name: lbrain.ai/claim.html

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package lbrain-coding-agents
Claude Code 
claude mcp add lbrain -- uvx lbrain-coding-agents==0.1.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "lbrain": {
            "command": "uvx",
            "args": [
                "lbrain-coding-agents==0.1.3"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. LBrain coding-agents
  2. Install the engine first
  3. Wire your coding agents
  4. Paste to a desktop AI (no terminal)
  5. Two-line wrap
  6. Agent Plugin
  7. Cookbooks
  8. Safety
  9. What this package is not
  10. License

LBrain coding-agents

Install LBrain where the agent already lives.

The free name is generic. Make it permanent: https://lbrain.ai/claim.html

Native MCP + companion skill + fail-closed session-start for Claude Code, Codex, Cursor, Copilot, Grok Build, Gemini CLI, Antigravity, and OpenClaw.

This package does not modify the LBrain engine. It wires hosts to lbrain mcp. The Official MCP Registry / VS Code @mcp gallery entry also execs that same stdio server.

VS Code: search LBrain in Extensions, or @mcp lbrain. Marketplace: https://marketplace.visualstudio.com/items?itemName=metavolve-labs.lbrain

Install the engine first

pip install "lbrain[local]"
lbrain init --source ~/notes
lbrain import && lbrain embed --stale

Wire your coding agents

pip install lbrain-coding-agents
python3 -m lbrain_agents status
python3 -m lbrain_agents install            # lists detections, changes nothing
python3 -m lbrain_agents install all        # every detected harness
python3 -m lbrain_agents install claude-code grok-build
python3 -m lbrain_agents install all --dry-run

A bare install is a no-op. That is deliberate: wiring every agent on the machine never happens by accident.

Paste to a desktop AI (no terminal)

Some people never open a shell. They paste this into Claude, Cursor, Codex, Copilot, or Grok and the agent does the work:

Install LBrain as my local memory.

pip install "lbrain[local]" lbrain-coding-agents
If python3 -m lbrain_agents works here, run: python3 -m lbrain_agents install all
Otherwise add an MCP server named lbrain: command lbrain, args ["mcp"], stdio.

Then call whoami. Prefer binds. Near-miss is not an answer. Abstain if nothing binds. SUPERSEDED must not govern. Leave LBRAIN_HOME alone if it is already set.

https://lbrain.ai/integrations.html

Existing lbrain MCP entries are left untouched unless you pass --force. Skills are copied to each host's skills directory. Session-start injects lbrain whoami (Claude Code).

Two-line wrap

from openai import OpenAI
from lbrain_agents.wrap import wrap_openai

client = wrap_openai(OpenAI(), home="~/.lbrain")

Recall first. If nothing binds, the model is told to abstain. Writes are opt-in (remember=True).

Agent Plugin

lbrain_agents/share/agent-plugin/ is a portable bundle (plugin.json + mcp.json + skill) for hosts that speak the Agent Plugins spec.

Cookbooks

  1. Abstain when the record does not bind
  2. SUPERSEDED does not govern
  3. Model swap, same mind

See lbrain_agents/share/cookbooks/.

Safety

  • Merges only the lbrain key. Other MCP servers stay.
  • Backs up a config once as *.lbrain-backup before the first write.
  • Does not set LBRAIN_HOME unless you pass --home. A working seat mount is not overwritten.
  • HTTP MCP is not enabled by this installer. stdio only. The engine's HTTP transport has no auth; do not bind it to the world.

What this package is not

This is the free installer and the serve-boundary skill. It is not LBrain Connect, Managed LBrain, or LBrain Govern. It does not issue gcx:// names, inscribe permanence, or ship study gold sets. The engine's resolver client is open; registrar issuance is not in this tree.

License

BSD-3-Clause. Metavolve Labs, Inc.

Patents pending. The licence covers the code; it does not grant patent rights.

Frequently asked questions

What is LBrain?

Local-first agent memory. Source, date, bind/abstain. Permanent name: lbrain.ai/claim.html

How do I install LBrain?

It runs on your machine. In Claude Code: claude mcp add lbrain -- uvx lbrain-coding-agents==0.1.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does LBrain need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is LBrain open source?

Yes. Its code is on GitHub under the BSD-3-Clause license.

Who maintains LBrain?

It is published by metavolve-labs. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.