br8n

Memoria de trabajo propia y portátil. Una plantilla de cerebro en archivos planos y un pequeño servidor MCP que permite que cualquier modelo la lea.

Todo lo que tu equipo ha enseñado a una herramienta de chat sobre cómo se hace el trabajo está dentro del inicio de sesión de otra persona. Cambia de herramienta y vuelves a ser un extraño. Este repositorio es la dirección opuesta: la memoria vive en archivos que posees, y el modelo es solo un lector.

br8n es la práctica de entrega de IA de Branded Mayhem Collective. Esta es la parte abierta: la estructura de archivos y la puerta. La instalación alojada añade recuperación, gobernanza y alguien que lo ejecute contigo — sobre los mismos archivos, que nunca cambian de forma. br8n.io

Qué hay aquí

• template/brain/ — la estructura del cerebro: how-we-work/, decisions/, exceptions/, handoffs/, voice/. Solo Markdown. Un archivo, una cosa. Escribe el porqué, para que el modelo pueda objetar más tarde.

• src/ — un servidor MCP (stdio) con tres herramientas: brain_list, brain_read, brain_search. La búsqueda devuelve archivo + línea para que las respuestas citen su fuente. Sin vectores, sin índice, sin cuenta. Grep es el punto.

Úsalo

git clone https://github.com/Branded-Mayhem-Collective-LLC/br8n
cd br8n && npm install && npm run build
cp -r template/brain ~/my-brain        # now write in it
node dist/cli.js ~/my-brain            # MCP server on stdio

Claude Desktop / Claude Code / Cursor (cualquier cliente MCP) — añade:

{ "mcpServers": { "br8n": { "command": "node", "args": ["/path/to/br8n/dist/cli.js", "/path/to/my-brain"] } } }

Luego pregúntale al modelo algo que el cerebro sepa. Responde desde el archivo y lo nombra. Cambia de modelo; misma respuesta, mismo archivo.

Por qué archivos

• Portátil. cp -r brain/ new-machine/ es toda la migración. Si no puedes hacer eso, no lo posees.

• Inspeccionable. Puedes leer cada byte que lee el modelo.

• Independiente del modelo. La carpeta no le importa qué modelo está al otro lado de MCP.

• Puede objetar. Una decisión almacenada con su porqué permite que un modelo diga «esto entra en conflicto con lo que decidiste en marzo». Un historial de chat no puede.

El método es público a propósito

La estructura y este servidor son MIT. Lo que br8n cobra es por manos en una operación real: extraer lo que realmente hay en las cabezas de las personas, dar forma a la recuperación para el rol, ejecutarlo y mantenerlo actualizado. Si prefieres hacerlo tú mismo, empieza aquí — la mayoría debería. El primer curso gratuito está en br8n.io/lab.

No afiliado

br8n en PyPI (un motor de captura de contexto de otro autor) no es este proyecto.

MIT © 2026 Branded Mayhem Collective LLC

Publicación (mantenedores)

npm login && npm publish --access public          # 1. claims `br8n` on npm; package.json carries mcpName
mcp-publisher login github                        # 2. GitHub device-flow auth (org member)
mcp-publisher publish                             # 3. lists io.github.Branded-Mayhem-Collective-LLC/br8n in the official MCP registry