Alfa · una versión temprana, probada en Ubuntu, macOS y Windows 11. Puede cambiar o fallar. Lee el aviso legal.
augmented brain

Para Claude Code · Linux, macOS y Windows · libre y gratis · alfa

Tu cerebro, aumentado con IA.

Tu asistente de IA recuerda en qué estabais, trabaja con método y te pregunta antes de tocar lo delicado. Todo queda en ficheros de texto tuyos, con copia en tu propio git.

Logo de augmented brain: un cerebro con el nombre encima

Míralo en marcha

Dos días de trabajo, en cuarenta segundos.

Claude · ~/augmented-brain/trabajo

Lunes, 9:00 · sesión nueva

¿En qué estábamos?
Tienes dos tareas vivas:
  • Formulario de contacto, aparcada. Siguiente: escribir el plan.
  • Renovar el certificado, en definición. Esperas a Marcos, que te pasa el dominio.
Seguimos con el formulario.
Quedamos en nombre, correo y mensaje, enviado por email. Te propongo el plan: el formulario, el envío y una prueba. ¿Empiezo?

… y trabajáis toda la mañana …

Lunes, 18:30

Apárcalo, mañana seguimos.
Aparcada. Hecho: el formulario y el envío. Siguiente: probarlo en local.

✓ Guardado en tasks/formulario-de-contacto.md

Martes, 9:00 · sesión nueva

¿Seguimos?
Ayer a las 18:30 dejamos el formulario hecho, con su envío. Toca probarlo en local. ¿Lo pruebo?
Funciona. Súbelo a producción.
🛡 El guardia te pregunta antes. aws --profile prod s3 sync … usa un perfil de producción.
PermitirNo

Un ejemplo recreado. Contigo, las tareas son las tuyas.

Qué hace en el día a día

Le hablas como siempre. Esto es lo que cambia.

“¿En qué estábamos?”

Te lista tus tareas vivas, cada una con su siguiente paso y con quién la está bloqueando.

“Apárcalo, mañana seguimos.”

Apunta dónde lo dejáis y qué viene después. Mañana, en una sesión nueva, arranca desde ahí.

“Apunta: renovar el certificado en noviembre.”

Va al buzón, sin abrir una tarea. Lo ordenáis en la revisión semanal.

“Recuérdame el jueves que llame al seguro.”

El jueves, nada más abrir Claude, te lo recuerda. Lo mismo con una fecha de una tarea: “mira en noviembre si se renovó el certificado”.

“¿Por qué elegimos Postgres?”

Lo busca en tus notas y te da la decisión, con su fecha y su porqué.

“Guárdalo como lección.”

Lo aprendido queda en una nota propia. La próxima vez que aparezca el tema, ya lo sabe.

“Borra el bucket viejo de producción.”

Antes de ejecutarlo, te pregunta. Producción la apruebas tú.

Abres Claude en ~/augmented-brain/personal

Solo ve tus notas personales. Las del trabajo se quedan en su cajón.

“Dile a Marcos que lo dejamos para el lunes.”

Sabe que Marcos es tu jefe, porque se lo contaste el primer día, y te prepara el mensaje.

Se te rompe el portátil

Un comando en el nuevo y lo tienes todo: notas, tareas y reglas. Más abajo, cómo.

Lunes, 9 de la mañana

El mismo lunes, dos veces.

Sin él

Seguimos con el formulario de contacto.
¡Claro! ¿Qué formulario? ¿Me cuentas de qué va el proyecto?

Quince minutos volviendo a explicarlo todo.

Con augmented brain

Seguimos con el formulario de contacto.
Está aparcado. Quedamos en nombre, correo y mensaje, enviado por email. Lo siguiente es el plan. ¿Empiezo?

Vuelves al trabajo sin más.

Tres cosas que le faltaban a tu asistente

Un cuaderno

Cada tarea, decisión y lección va a un fichero de texto en tu máquina. En la siguiente sesión, el asistente lo lee lo primero.

“¿Qué campos llevaba el formulario?” Está en su tarea, con fecha.

Un método

Como la checklist de un piloto: cada tarea va de la idea a terminada por los mismos seis pasos. Nada se queda a medias.

“Apárcalo” guarda dónde estás y el siguiente paso, como un marcapáginas.

Un portero

Hay puertas que solo abres tú: subir código, entrar como root, escribir una contraseña en un fichero.

El asistente tiene que preguntarte antes.

La vida de una tarea

Seis pasos, como una receta. Entre uno y otro, dices “adelante”; dentro de cada uno, el asistente trabaja sin más.

  1. DefinirQué queremos y cómo sabremos que ha funcionado.“Un formulario: nombre, correo, mensaje.”
  2. AnalizarCómo están las cosas de verdad. Comprobado, no supuesto.“La web ya envía correos.”
  3. PlanificarPasos en orden, cada uno con vuelta atrás.“Formulario, validación y envío.”
  4. HacerTrabajar, con un diario con fecha.“16-oct — filtro de spam puesto.”
  5. ValidarProbar que funciona, de verdad.“Mandé uno. Llegó.”
  6. CerrarSe guarda siempre, nunca se borra.“Hecho. Lección: probar antes en el móvil.”

El portero, trabajando

Reglas de verdad, comprobadas antes de cada comando. También si va escondido dentro de otro, o por ssh.

Tus notas son ficheros

Markdown en una carpeta. Ábrelas con cualquier editor. Sin cuenta, sin almacenamiento en la nube, sin ataduras. Si mañana dejas augmented brain, tus notas se quedan.

El asistente lee la cabecera. El resto lo escribes tú, en el idioma que quieras.

tasks/task-formulario-contacto.md---
title: Formulario de contacto
status: parked
waiting_on: nobody
next: Escribir el plan
---
## Lo esencial
Nombre, correo y mensaje, enviado por email.

## Diario
- 2026-10-15 — Campos acordados.
- 2026-10-15 — Aparcada: plan mañana.

Pierdes el portátil, no el cerebro

Cada cajón puede tener su copia en un repositorio git privado tuyo. Esto es lo que te da:

  • Una máquina nueva en minutos. augmented-brain restore trae el cajón entero: notas, tareas, reglas, tu perfil y su configuración. Abres Claude y sigue donde lo dejaste.
  • Varias máquinas, un solo cerebro. ¿Portátil y sobremesa? Cada copia trae primero lo que hizo la otra máquina y lo mezcla.
  • Todo el historial. Cada copia es un commit de git, con la máquina y la hora. Puedes ver qué cambió y volver a cualquier día.
  • En tu sitio, no en el nuestro. GitHub, GitLab o tu servidor: el repositorio lo eliges tú. augmented brain no tiene nube.
  • Un repositorio por cajón. Lo del trabajo puede vivir en el git de la empresa, y lo personal en el tuyo.
  • No sube secretos. Si una nota tiene algo que parece una contraseña o un token, la copia se para y te dice dónde.
  • No pisa nada. Si dos máquinas cambiaron la misma nota, se para sin tocar nada y te dice cómo arreglarlo.

Se monta una vez

augmented-brain backup setup \ git@github.com:tu-usuario/mi-cerebro.git
augmented-brain backup

Lo más fácil: dile a Claude “monta la copia de seguridad” y crea un repositorio privado en tu GitHub. Si prefieres otro sitio, el primer comando conecta el cajón con tu repositorio, una vez. Desde entonces la copia se hace sola cada vez que termina una sesión de Claude; el segundo la hace a mano, si quieres (--all para todos los cajones).

Y además

Dos cajones

Trabajo y personal, cada uno con sus notas, sus reglas y su copia. La carpeta donde abres el asistente elige el cajón.

Lecciones que se quedan

“Guárdalo como lección” y lo aprendido no se pierde con la conversación. Se ordena por áreas.

Con tus palabras

“Tarea nueva…”, “¿qué tengo pendiente?”, “apárcalo”, “apunta esto para luego”. No hay comandos que aprender.

Áreas

Lo que cuidas siempre, como “la web” o “los servidores”, agrupa sus tareas y lo que aprendiste.

Tus herramientas

Calendario, correo, documentos y Jira pueden sumarse. Cómo conectarlos.

No depende de una IA

El método funciona como servidor MCP, el estándar abierto para herramientas de IA. Primero Claude Code; otros pueden venir después.

Empieza en dos pasos

Unos minutos, en Linux, macOS o Windows, con una cuenta de Claude de pago (Pro o superior). ¿Nunca has abierto una terminal? Sigue los primeros pasos. Lo que cambia en cada sistema: Instalación.

  1. Instálalo con un solo comando. Te pregunta el idioma y te ofrece instalar lo que falte: git, Claude Code y la app de escritorio de ClaudeEn Linux o en Mac, en la terminal:
    curl -fsSL https://github.com/icalvete/augmented-brain/releases/latest/download/install.sh | sh
    En Windows, en PowerShell:
    irm https://github.com/icalvete/augmented-brain/releases/latest/download/install.ps1 | iex
  2. Contesta a Claude: la primera vez te hace seis preguntas rápidas, y te explica para qué sirve cada una

Crea dos espacios, trabajo y personal, en ~/augmented-brain, y te pregunta si abre Claude ya. Las próximas veces, abre la app de Claude y pulsa + New: sin elegir carpeta estás en tu espacio personal; para el de trabajo, elige ~/augmented-brain/trabajo con Choose…. O en una terminal: cd ~/augmented-brain/trabajo && claude (en Windows, cd ~\augmented-brain\trabajo; claude). Si algo no va, augmented-brain doctor te dice qué falta.

Todos los comandos
augmented-brain initLo prepara todo: los espacios trabajo y personal y el plugin (lo lanza el instalador; --custom para elegir tú)
augmented-brain space addAñade otro espacio: personal, un cliente…
augmented-brain doctorDice qué falta y cómo arreglarlo
augmented-brain checkRevisa las notas de esta carpeta y rehace su índice
augmented-brain backup setup <url>Copia este espacio en un repositorio git privado
augmented-brain backupGuarda los últimos cambios (--all para todos los espacios)
augmented-brain restore <url>Recupera un espacio en una máquina nueva
augmented-brain updateActualiza augmented brain y su plugin de Claude Code (Claude te avisa cuando hay versión nueva)
augmented-brain uninstallQuita el programa y el plugin; tus notas se quedan

Preguntas

¿Es gratis?

augmented brain, sí: es software libre, con licencia MIT, sin cuenta y sin suscripción. Pero trabaja con Claude Code, que necesita una cuenta de Claude de pago (Pro o superior).

¿Mis notas salen de mi máquina?

augmented brain no las envía a ningún sitio: se quedan en ficheros en tu máquina. Tu asistente las lee para trabajar, como cualquier otro fichero que abre, así que viajan con la conversación. Con una copia de seguridad, van además a un repositorio git privado que eliges tú.

¿Con qué asistentes funciona?

Hoy, con Claude Code. El método funciona como servidor MCP, así que cualquier asistente que hable MCP puede usarlo; vendrán adaptadores para otros.

¿Funciona en Windows?

Sí: Windows 10 y 11, con un comando de PowerShell. Claude ejecuta sus comandos en Git Bash, que deja instalado el instalador, así que el guardia también funciona allí. Mira Instalación.

¿Puedo editar las notas a mano?

Sí, son ficheros Markdown. Después, augmented-brain check las revisa y rehace el índice.

¿La copia se hace sola?

Sí. Una vez montada, se hace sola cada vez que termina una sesión de Claude, en segundo plano. Si falla, Claude te lo dice al empezar la siguiente sesión.

¿Cómo puedo apoyarlo?

Patrocínalo en GitHub Sponsors. Paga el tiempo de responder incidencias y añadir funciones.

¿Hay soporte de pago?

Sí, en GitHub Sponsors: el nivel Support te da respuesta por correo en dos días laborables, y la Setup session es una hora por videollamada para dejarlo montado contigo.

¿Y si dejo de usarlo?

Tus notas se quedan donde están, como ficheros normales. No hay nada que exportar.