Log inSubmit server
Robrain logo

Robrain

by adelinamart

Captures coding decisions and rejected alternatives, then warns agents before they repeat a vetoed approach.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Robrain

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "adelinamart-robrain": {
      "command": "npx",
      "args": [
        "-y",
        "robrain@latest"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_VALUE_HERE",
        "OPENAI_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

adelinamart/robrain records architectural decisions and rejected alternatives across coding-agent sessions, using Postgres with pgvector for shared memory. Its passive capture pipeline extracts decisions without manual tagging, while veto warnings surface prior reasoning before an agent proposes the same approach again. Corpus-wide synthesis identifies drift, contradictions, and recurring entities across sessions. Reach for it when multiple agents or teammates need shared decision history across Claude Code, Cursor, Copilot, and Codex.

Use cases

  • Capture architectural decisions across coding-agent sessions
  • Warn agents before repeating rejected implementation approaches
  • Share decision history between Cursor, Claude Code, Copilot, and Codex
  • Review contradictions and stance drift across a project corpus

Key features

  • Passive decision capture
  • Structured rejected alternatives
  • Cross-editor shared memory
  • Pre-task veto warnings
  • Postgres and pgvector storage
  • Corpus-wide synthesis

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

21/21 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · robrain@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars81Stargazers on the source repository.
npm downloads932Package downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Robrain works

What adelinamart/robrain MCP server does

adelinamart/robrain gives coding agents shared decision memory with explicit records of alternatives that a team rejected. It is designed to prevent an agent from repeatedly suggesting an approach that was already ruled out, even when the original decision was made in another editor or by another teammate.

The system focuses on two functions: capturing decisions from session activity and applying judgment to the stored corpus. Captured decisions can include a structured rejected[] field containing the alternatives and rationale that should inform future work. Memory is shared across supported tools through the same backend rather than being tied to one editor.

Self-hosted installations keep the database, API keys, and processing on the user's machine. A managed Rory Plans option handles hosting and extraction for paid-plan users, with team or individual memory spaces depending on the plan.

How it works

Sensing observes session turns and sends them through Perception, which classifies and extracts decisions into Postgres. The default provider setup uses Anthropic for extraction and OpenAI for embeddings, while the project also describes OpenAI-only, Gemini, alternative embedding, and fully local arrangements.

After installation, init-project adds project instructions for Claude Code, Codex CLI, and Cursor. Sessions then load an always-on summary, and capture occurs without requiring users to tag each turn. The capture classifier can be adjusted per project with natural-language instructions, confidence thresholds, capture modes, and additional memory kinds.

Synthesis examines the complete decisions table rather than capturing new entries. Its passes look for stance drift, incompatible decisions from different sessions, and recurring tools or patterns that can be condensed into planning blocks. Findings are written back as flags and edges for review.

Setup and configuration

The self-hosted path starts with npx robrain@latest up, which starts Postgres and the Perception service and generates stack credentials under ~/.robrain/stack/.env. The default setup requires Anthropic and OpenAI API keys. Run npx robrain install --self-hosted to connect the Sensing MCP component to editors.

For a project, run npx robrain init-project from the repository root. This writes CLAUDE.md, AGENTS.md, and a Cursor rule file. npx robrain doctor helps investigate missing captures, while npx robrain review provides a way to inspect and approve captured rows. The Claude Code plugin adds hook-based capture and pre-task warnings for self-hosted users.

The managed route uses npx robrain install, followed by an API token from Rory Plans. It avoids local Docker, Postgres, LLM keys, and embedding keys; extraction and search run remotely. The cloud setup is available on paid Rory Plans subscriptions.

Tools and capabilities

  • Passively capture decisions from agent session turns.
  • Store rejected alternatives in structured rejected[] records.
  • Load prior decision summaries when a session starts.
  • Warn agents before they re-propose rejected approaches.
  • Explain the decision history associated with a file.
  • Review captured rows before accepting them.
  • Tune capture instructions, confidence, modes, and memory kinds.
  • Scan the corpus for drift and contradictions.
  • Promote recurring entities into planning blocks.

Limitations and notes

Synthesis is available locally through the self-hosted setup; managed installations run judgment server-side. Only decisions carry vetoes, while additional memory kinds represent changing state or other project-specific information. The repository describes coding as the first supported vertical, although the underlying architecture is intended for longer-lived agent decisions more broadly.

Self-hosted operation depends on a running Postgres and Perception stack, as well as credentials for the selected extraction and embedding providers. After changing installation or generated project configuration, editors may need a full restart.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Robrain

adelinamart/robrain is an MCP server that connects coding agents to shared decision memory in Postgres with pgvector. Its main tools capture decisions passively, retain rejected alternatives, warn before agents repeat vetoed approaches, explain file history, review records, and scan the corpus for contradictions and drift.

Install it with `npx robrain@latest up` followed by `npx robrain install --self-hosted` for a local stack, or run `npx robrain install` for Rory Plans cloud. The self-hosted setup uses Postgres and Perception and normally requires Anthropic and OpenAI API keys.

Yes, adelinamart/robrain supports Cursor. Installation can create `.cursor/rules/robrain.mdc` with `alwaysApply: true`, allowing the project to load shared decision context and capture session activity alongside other supported coding tools.

Yes, its Synthesis process scans the full decisions corpus for contradictions and stance drift. Run `npx robrain synth` in self-hosted mode, then use `npx robrain review` to inspect the resulting findings.

Related MCP servers

All in Knowledge & Memory All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewRobrain AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/adelinamart-robrain?style=directory)](https://allmcps.com/mcp/adelinamart-robrain)
HTML Embed
<a href="https://allmcps.com/mcp/adelinamart-robrain"><img src="https://allmcps.com/api/badge/adelinamart-robrain?style=directory" alt="Robrain on AllMCPs" /></a>