Cómo funciona

augmented brain es un programa pequeño y una carpeta de notas. Así encajan las piezas:

Cuatro capas

Capa	Qué es	Dónde vive
3 · Tú y tu asistente	Hablas con Claude Code como siempre. No hay comandos nuevos que aprender.	Tu terminal
2 · El plugin	Las puertas por las que Claude entra al programa: dos hooks y un servidor MCP.	Dentro de Claude Code, que lo instala
1 · El programa	`augmented-brain`, un solo fichero. Vigila los comandos, lleva las tareas, rehace el índice y hace la copia.	`~/.local/bin/augmented-brain`
0 · Tus ficheros	Texto normal: la configuración, tus notas y, si quieres, su copia.	`~/.config/augmented-brain/`, `~/augmented-brain/` y tu repo git

Dicho de otra forma: tus notas son un cuaderno, el programa es quien lo ordena y el plugin es la puerta. Tú solo hablas con Claude; Claude entra por la puerta y el programa escribe en el cuaderno.

Dos palabras que salen mucho:

Hook: un aviso que Claude Code lanza en un momento concreto. Aquí, al empezar la sesión y antes de cada comando. En cada aviso, Claude Code arranca el programa, le pregunta y el programa termina. No queda nada funcionando de fondo.
MCP (Model Context Protocol): un estándar abierto para dar herramientas a un asistente. El programa ofrece las suyas (“abre una tarea”, “apárcala”) y Claude las usa. Al ser un estándar, otros asistentes podrán usar las mismas.

Una sesión, paso a paso

1. Abres Claude. El hook de inicio mira en qué carpeta estás y elige tu espacio. Antes de que escribas nada, le pasa a Claude tu perfil, tus reglas y la lista de tareas vivas. Por eso sabe dónde lo dejaste.

2. Dices “apárcala”. Claude usa la herramienta task_park. El programa apunta en el fichero de la tarea dónde se quedó y cuál es el siguiente paso, y rehace el índice. La próxima sesión empieza desde ahí. Abrir, retomar y cerrar funcionan igual.

3. Claude va a ejecutar un comando. El hook del guardia lo lee antes y decide:

Adelante: casi siempre. ls, go test, aws --profile dev s3 ls.
Te pregunta: producción, o una máquina que marcaste como intocable. aws --profile prod …, ssh db01 ….
Lo para: subir código, root y secretos. git push, sudo …, un token en un comando.

También mira dentro de ssh, de bash -c y de los bucles. Lee la shell, no PowerShell, así que para también cualquier comando de PowerShell, y Claude lo hace en Bash. Es una red contra despistes, no un muro de seguridad: lee el aviso legal.

Lo que vence ese día. Si una tarea tiene una fecha de aviso para hoy o mañana, o algo apuntado con “recuérdamelo el jueves”, Claude te lo dice nada más empezar. Y si hace una semana o más de la última revisión y hay cosas en el buzón o tareas paradas, te ofrece la revisión semanal: unos diez minutos repasando contigo cada cosa.

4. Cierras la sesión. El hook de cierre lanza la copia de seguridad del espacio, por detrás, si la tienes montada. No esperas a nada. Si falla, Claude te lo dice al empezar la siguiente.

Tus ficheros

Todo vive en ~/augmented-brain, con una carpeta por espacio. Trabajas dentro de ella, y sus notas van en notas/:

~/augmented-brain/
├── trabajo/              abre Claude aquí para lo del trabajo
│   ├── notas/
│   │   ├── MEMORY.md     el índice que Claude lee al empezar (lo genera el programa)
│   │   ├── inbox.md      apuntes rápidos, para ordenar luego
│   │   ├── areas/        lo que cuidas siempre: "la web", "los servidores"
│   │   ├── tasks/        un fichero por tarea
│   │   ├── knowledge/    cómo funcionan las cosas y lo aprendido
│   │   ├── people/       con quién tratas, para saber quién es "Marcos"
│   │   ├── rules/        reglas solo de este espacio
│   │   ├── reviews/      revisiones semanales
│   │   └── archive/      lo antiguo; no se carga y no se borra
│   └── (tus proyectos)
└── personal/             y aquí para lo personal, con sus propias notas/

Tu perfil, quién eres y cómo te gusta trabajar, es uno para todos los espacios: ~/.config/augmented-brain/profile.md. No hace falta escribirlo a mano: la primera vez que abres Claude, te hace seis preguntas rápidas, explicándote el porqué de cada una. Con tus respuestas guarda el perfil, crea tus áreas, le dice al guardia qué es producción y qué máquinas no se tocan, y apunta a las personas con las que trabajas. Para cambiar cualquier cosa, díselo.

Una tarea es un fichero de texto. Arriba, entre las líneas ---, los datos que usa el programa. Debajo, lo que escribís tú y Claude:

---
id: task-anadir-un-formulario-de-contacto
type: task
title: Añadir un formulario de contacto
area: area-web
status: parked
waiting_on: me
next: Escribir el plan
created: "2026-10-15"
updated: "2026-10-15"
---
## Lo esencial
Nombre, correo y mensaje, enviado por email.

## Diario
- 2026-10-15 — Tarea abierta.
- 2026-10-15 — Aparcada. Siguiente: Escribir el plan

Puedes abrir y editar todo con cualquier editor. El formato completo está en memory-format.md (en inglés).

Trabajo y personal, separados

Un espacio es un juego completo de notas, reglas y copia. El instalador crea dos, trabajo y personal. La carpeta donde abres Claude elige el espacio, según tu configuración:

# ~/.config/augmented-brain/config.toml
default_space = "personal"

[spaces.trabajo]
memory = "~/augmented-brain/trabajo/notas"
work_folders = ["~/augmented-brain/trabajo"]

[spaces.personal]
memory = "~/augmented-brain/personal/notas"
work_folders = ["~/augmented-brain/personal"]

En ~/augmented-brain/trabajo/web, Claude ve las notas del trabajo. En ~/augmented-brain/personal/blog, las personales. Nunca se mezclan.

¿Y si abres Claude en otra carpeta? Por ejemplo, la app de escritorio empieza cada sesión nueva en una carpeta temporal suya. Entonces se usa el espacio por defecto, personal, y Claude te lo dice en una línea, con cómo pasar al de trabajo. Puedes cambiarlo en default_space, o quitarlo.

¿Tus proyectos ya viven en otra carpeta, como ~/code? Añádela a work_folders del espacio que toque. Para un espacio nuevo (un cliente, por ejemplo): augmented-brain space add cliente.

La copia de seguridad

La carpeta de notas de cada espacio es también un repositorio git. La copia lo sube a un repositorio privado tuyo, uno por espacio.

Montarla: pídeselo a Claude. Dile “monta la copia de seguridad” (al final de la entrevista ya te lo ofrece). Crea en tu cuenta de GitHub un repositorio privado, augmented-brain-<espacio>, lo conecta y hace la primera copia. Para eso usa gh, la herramienta oficial de GitHub: si no la tienes, Claude te dice cómo instalarla y te guía en el único paso que necesita tu navegador, entrar con tu cuenta. ¿Prefieres otro sitio (GitLab, el git de tu empresa)? Dale la dirección del repositorio, o hazlo tú:

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

Desde entonces se hace sola cada vez que terminas una sesión de Claude, en segundo plano. Si falla (sin conexión, sin permiso en el repositorio), Claude te lo dice al empezar la siguiente. También puedes lanzarla a mano:

augmented-brain backup          # este espacio
augmented-brain backup --all    # todos

En una máquina nueva

Instala augmented brain con el comando de siempre. Te crea los espacios vacíos. Si al acabar se abre Claude, ciérralo sin hacer la entrevista: tu perfil viene en la copia.
Recupera cada espacio desde su copia:
```
augmented-brain restore https://github.com/tu-usuario/augmented-brain-trabajo.git
```
Sustituye el espacio vacío por el tuyo: notas, tareas, reglas, tu perfil y la configuración del espacio. Si ese espacio ya tuviera notas tuyas, no lo pisa.
Abre Claude. Sigue donde lo dejaste, y la copia sigue haciéndose sola.

Si el repositorio está en GitHub, antes de restaurar entra una vez con gh auth login para que git tenga permiso.

Lo que te da:

Una máquina nueva en minutos, con los tres pasos de arriba.
Varias máquinas, un solo cerebro. Antes de subir, la copia trae lo que hizo tu otra máquina y lo mezcla.
Todo el historial. Cada copia es un commit de git, con la máquina y la hora. Con git log ves qué cambió y puedes volver a cualquier día.
En tu sitio. GitHub, GitLab o tu servidor: el repositorio lo eliges tú. No hay nube de augmented brain.
Un repositorio por espacio. El del trabajo puede ir al git de la empresa y el personal al tuyo.
No sube secretos. Si una nota tiene algo que parece una contraseña o un token, la copia se para y te dice en qué fichero.
No pisa nada. Si dos máquinas cambiaron la misma nota, se para sin tocar nada y te explica cómo resolverlo. El índice, que es generado, se rehace solo.

Para apagar la copia automática: AB_NO_AUTO_BACKUP=1.

Lo que no hace

No hay servidor ni cuenta. Si Claude no está abierto, no funciona nada.
No envía tus datos a nadie. Solo la copia, si la configuras, habla con tu repositorio. Aparte, una vez al día, pregunta a GitHub cuál es la última versión, sin mandar nada tuyo. AB_NO_UPDATE_CHECK=1 lo apaga.
No toca tus ajustes de Claude Code. El plugin se pone y se quita con los comandos de Claude Code, que el instalador, update y uninstall lanzan por ti.
Ojo: tu asistente lee tus notas, como cualquier fichero que abre. Viajan con tus conversaciones a su proveedor. No guardes ahí lo que no compartirías.

Actualizarlo

Cuando hay versión nueva, Claude te lo dice al empezar una sesión y se ofrece a actualizarlo. También puedes hacerlo tú:

augmented-brain update

Actualiza el programa y el plugin de Claude. Tus notas y tu configuración no se tocan. Después, cierra y abre Claude para que use la versión nueva.

Quitarlo

augmented-brain uninstall

Quita el plugin de Claude y el programa, después de preguntarte. Tus notas se quedan en ~/augmented-brain/: son tuyas. También se quedan tu configuración (para borrarla: augmented-brain uninstall --config), Claude Code, su app y git. Si vuelves a instalarlo, lo encuentras todo como estaba.

← Volver a augmented brain