brain — the recorder

Name: brain — the recorder
Author: mordechaipotash

de mordechaipotashversión 2.0.0i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.mordechaipotash/brain-mcp

Instalar

Resumen

Descripción del creador (original en inglés)

Records your Claude Code, Codex and Pi history before deletion. Cited-or-abstain recall.

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiMuy nuevo↓ 179/sem · ★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Herramientas para desarrolladores

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: BRAIN_HOME

Necesitas

PyPIuv de Python instalado (para el comando uvx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "brain": {
      "command": "uvx",
      "args": [
        "brain-mcp"
      ],
      "env": {
        "BRAIN_HOME": "your-value"
      }
    }
  }
}

Ejecuta esto en tu terminal

claude mcp add brain --env BRAIN_HOME=your-value -- uvx brain-mcp

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "brain": {
      "command": "uvx",
      "args": [
        "brain-mcp"
      ],
      "env": {
        "BRAIN_HOME": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "brain": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "brain-mcp"
      ],
      "env": {
        "BRAIN_HOME": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

BRAIN_HOME env
Data directory for the floor (default ~/.brain)

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 8 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub mordechaipotash, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Herramientas para desarrolladoresi

Más estrellas que el 0% de los otros 5135 servidores de esta categoría
Publicado en el registro más recientemente que el 53% de los otros 5135 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 5135 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro brain — the recorder?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (2.0.0) llegó al registro hace 35 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: GitHub, Desktop Commander, Cloudflare MCP

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

GitHub

Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

de githubMuy usado★ 34,2 milActualizado hace 5 días

Computadora o nube

Instalar

Desktop Commander

MCP server for terminal commands, file operations, and process management

de wonderwhy-erMuy usado↓ 709,6 mil/sem★ 10,2 milActualizado hace 17 días

Se ejecuta en tu computadora

Instalar

Cloudflare MCP

Cloudflare MCP servers

de cloudflareEn crecimiento★ 4,4 milActualizado hace 14 meses

Se ejecuta en la nube✓ mcp.cloudflare.com

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

brain-mcp — the recorder for your AI conversations

Your AI history is being deleted right now. Claude Code deletes session files older than cleanupPeriodDays (default 30) at startup. Run this and see your own cliff edge:

# macOS

find ~/.claude/projects -name '*.jsonl' -exec stat -f '%Sm %N' -t '%Y-%m-%d' {} + | sort | head -3

Linux

find ~/.claude/projects -name '*.jsonl' -printf '%TY-%Tm-%Td %p\n' | sort | head -3

The oldest date you see is where your history ends. brain-mcp records it before it goes — the whole session, subagent transcripts and saved tool output included, byte-exact, content-hashed, locally — makes it queryable with citations you can verify with sed and shasum, tells you what was deleted, and puts it back.

If Claude Code deleted it

brain-mcp health          # the receipt: "3 session(s) and 41 file(s) are gone from where the

agent kept them; the floor holds every one" — each re-hashed

against the manifest when the recorder first noticed it

brain-mcp restore --list # what can be put back brain-mcp restore # writes the session (and its folder) back, byte-exact, then:

cd && claude --resume

restore never overwrites different bytes (identical bytes are a no-op), is all-or-nothing, and takes --dry-run and --to . It is a CLI verb only — no MCP tool writes outside the floor.

Install

pipx install brain-mcp           # or: uvx brain-mcp

brain-mcp install cc # CC hooks + 60-second scheduler brain-mcp serve # the MCP server (stdio) — add to your client config

Or as a Claude Code plugin (hooks + server in one step):

/plugin marketplace add mordechaipotash/brain-marketplace

/plugin install brain

What it does

Captures at source. Claude Code via Stop/SessionEnd hooks (line-deltas + a final snapshot); Codex, Pi, and everything inside a Claude Code session's own folder (subagent and workflow transcripts, .meta.json, tool-results/) via a 60-second poll-scan. One spool, one floor.
Keeps the bytes. The floor is ~/.brain/lake/ / .jsonl — append-only, byte-identical to the original, with an append-only sha256 manifest. Nothing is parsed and discarded; the DuckDB index is a cache, fully re-derivable from the lake.
Cites or abstains. Every search hit carries {file, line span, sha256} — checkable by anyone with sed -n 'A,Bp' file | shasum -a 256, no database required. Zero hits return an explicit abstention naming the lanes and dates actually searched.
Reports health honestly. fresh = the floor holds everything the agent's files show; stale = the agent has content the recorder missed; `unknown` = unmeasured, not healthy — never folded into "looks fine".
Backs up verifiably. brain-mcp backup syncs lake+manifest and re-hashes sampled files at the destination. The verify can fail; that is the point.
One network fetch, ever, and it is not about you. No telemetry, no cloud, no accounts, and no HTTP client in this package. The exception: DuckDB downloads its full-text-search extension (fts) from DuckDB's own extension repository the first time the index is built, and caches it under ~/.duckdb. brain-mcp install does that fetch up front and says so; brain-mcp doctor reports whether it is cached.

The 7 MCP tools

tool	what
`brain_search`	BM25 over everything recorded; cited hits or an explicit abstention
`brain_get`	the raw lines behind a citation, with sha verification
`brain_recent`	time-ordered recent activity, every row cited
`brain_sessions`	session cards per day/agent
`brain_health`	per-lane origin-vs-floor freshness (unknown ≠ healthy), plus the receipt of what the agents deleted
`brain_capture_status`	is the machinery itself moving (spool, heartbeats, floor)
`brain_backup`	verified backup; writes only outside the floor

🤖 For AI Assistants

*You're reading this because your human runs THE RECORDER and gave you access to their AI history. This is the honesty contract.*

The one rule: everything you state from these tools is either CITED or ABSTAINED — there is no third state. A cited claim carries a checkable pointer (file + line span + sha256); verify it with brain_get(expect_sha256=...) before building on it. An abstention means "not found above threshold in the lanes and dates the tool measured" — it does NOT mean "it never happened". Never fill an abstention with your own guess.

Present recall as their words, dated: *"On 2026-08-19 you wrote: '…' (sess-7f2a.jsonl:412)"* — never as your own knowledge. One claim, one citation.
verified: false from brain_get means the floor changed since indexing. Say so plainly.
A health response containing any unknown lane is never "everything looks fine". The honest sentence is: "2 lanes fresh, 1 stale, 1 unmeasured."
"What do I think about X" → brain_search(query, role="user"). That returns what the PERSON wrote: text the harness injected under the user role (skill bodies, reminders, slash-command wrappers, compaction summaries, Codex context blocks — a quarter to two thirds of "user" rows, measured) is excluded unless you pass include_machine=True, and subagent transcripts unless include_subagents=True. "How did my thinking evolve" → add order="time_asc"; bound it with since / until. The server has no opinion about your human's mind; it has their words, with receipts.

The floor format

~/.brain/

spool/ / hooks + scanner write here (atomic, dot-tmp invisible) lake/ / .jsonl THE FLOOR: append-only, byte-identical to the origin; a rewrite opens .g2.jsonl — old kept, never deleted lake/cc_sessiondir/ / /... a CC session's folder, mirrored at the same relative paths (subagents/, tool-results/, *.meta.json) manifest/manifest.jsonl one versioned line per chunk: byte range, line range, sha256 offsets/ / hook fast-path line counters health/*.last_run side-effect heartbeats (mtimes are the proof, never a report) brain.duckdb the index — a cache, re-derivable from lake/ + manifest/

Where your agents keep their transcripts: Claude Code ~/.claude/projects/**/*.jsonl (rolling window!), Codex ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl, Pi ~/.pi/agent/sessions/**/*.jsonl.

Other verbs

brain-mcp record                  # one capture tick (the scheduler runs this every 60s)

brain-mcp health [--exit-nonzero-on-stale] # cron-able brain-mcp doctor # capture status, health, fts cache, the receipt, runaway generations brain-mcp restore [ ] [--list] [--to DIR] [--dry-run] # put a deleted session back brain-mcp redact --lines A B --reason "..." # tombstone a secret; audited in manifest brain-mcp migrate-v1 # import v1 data (marked v1_derived) brain-mcp uninstall # removes hooks + scheduler; your floor is KEPT

v1 → v2

v2 is a rebuild around one principle: capture the bytes first; derive everything else. v1 parsed conversations into a parquet and discarded the originals — v2's floor makes that structurally impossible. v1's 25 tools became 7: the synthesis tools ("cognitive patterns", "switching cost") are gone because a claim that can't carry a line-span citation isn't one this server makes. Migration: brain-mcp migrate-v1 — v1 rows are kept, marked as derived, and floor-backed rows win wherever the source still exists.

Windows: out of scope for v2.0. Scheduling is LaunchAgent (macOS) / systemd user timer (Linux).

MIT.

brain — the recorder

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Herramientas para desarrolladoresi

Preguntas frecuentes

Alternativas

GitHub

Desktop Commander

Cloudflare MCP

README del creador

brain-mcp — the recorder for your AI conversations

Linux

If Claude Code deleted it

agent kept them; the floor holds every one" — each re-hashed

against the manifest when the recorder first noticed it

cd && claude --resume

Install

What it does

The 7 MCP tools

🤖 For AI Assistants

The floor format

Other verbs

v1 → v2