Second Brain OS: monta una base de conocimiento que se organiza sola con Claude Code

Para quién es

• Para quienes quieren usar Claude Code para construir una base de conocimiento que se organiza sola: recoges artículos y notas y quieres que se extraigan automáticamente, que se enlacen entre sí mediante backlinks y que se mantengan ordenadas, en lugar de acumularse como un montón de archivos que nadie vuelve a mirar.
• Ofrece una guía completa, un vault inicial, agent skills y scripts; funciona sobre archivos markdown, wikilinks y SKILL.md, y también sirve para cualquier agente capaz de leer archivos. Obsidian es solo el visor de grafos, no una dependencia.
• Cuándo NO encaja: si buscas un software de notas gráfico listo para usar y no estás dispuesto a clonar un repositorio en la terminal, copiar directorios y ejecutar un agente, este flujo no es para ti. La evidencia oficial no indica qué clientes concretos admite más allá de esos agentes, qué idiomas de texto soporta, ni si hay restricciones aparte de la ausencia de pago o de registro: es gratuito y no requiere cuenta, pero otros límites son desconocidos.

Primer intento en 3 minutos

La vía principal oficial es instalarlo en local en ~/brain desde la terminal y arrancar Claude Code en ese directorio:

1. Requisitos previos: tener instalados git y Claude Code (el agente); se recomienda instalar también Obsidian para ver el grafo.
2. Ejecuta en la terminal el comando de instalación oficial, que copia el vault inicial junto con skills, commands y agents a ~/brain/.claude:

git clone https://github.com/undefined-ui/second-brain-os.git
cp -r second-brain-os/vault-template ~/brain

mkdir -p ~/brain/.claude
cp -r second-brain-os/skills   ~/brain/.claude/skills
cp -r second-brain-os/commands ~/brain/.claude/commands
cp -r second-brain-os/agents   ~/brain/.claude/agents

cd ~/brain && claude

1. Efectos secundarios y puntos de confirmación: estos comandos crean ~/brain en tu directorio de usuario y escriben archivos; si el destino ya existe, verifica tú mismo si quieres sobrescribirlo.
2. Lanza una primera tarea de bajo riesgo: guarda o pega un artículo como archivo en el directorio raw/ y luego escribe /ingest en Claude Code. Este es el flujo de trabajo oficial central: el agente ingiere el material, extrae lo relevante, crea enlaces y limpia la materia prima, organizándola en un wiki interconectado. Lee y escribe archivos markdown dentro del vault; si ejecuta otros comandos o accede a la red no lo aclara la evidencia oficial, así que trátalo como desconocido. Si el artículo contiene datos sensibles, anonimízalo antes de ponerlo en raw/.
3. Señal de éxito: el artículo de raw/ se convierte en páginas de notas con wikilinks dentro del vault; la regla oficial es "Nothing is ingested until it is linked" (nada se ingiere hasta que está enlazado): si en esa ronda no se completó el enlazado, la ingesta no está terminada. Por eso, comprueba que las páginas nuevas contienen realmente enlaces hacia otras notas: ese es el criterio para saber que la ronda de /ingest ha concluido. La evidencia oficial no detalla qué comprobaciones incluye /ingest internamente ni si hay flujos distintos según el tipo de texto; no lo asumas.

Casos de uso

Caso 1: archivar artículos coleccionados. Sueles recortar artículos con el navegador pero nunca los vuelves a leer. Escenario: guarda un artículo recortado en ~/brain/raw/ y ejecuta /ingest en Claude Code. Seguirá el flujo de ingesta oficial: extraer los puntos clave, enlazar con notas existentes y limpiar. Resultado esperable: los archivos de raw se convierten en páginas wiki enlazadas; si notas que una página nueva carece de enlaces, según la regla oficial esa ingesta se considera incompleta y puedes pedir al agente que complete los enlaces.

Caso 2: ver el grafo de conocimiento con Obsidian. Escenario: tras varias ingestas, quieres comprobar las conexiones entre notas. Cómo hacerlo: abre ~/brain como vault en Obsidian (el visor de grafos indicado en la documentación oficial) y explora el grafo formado por las notas y los wikilinks. Lo que puedes confirmar: el vault es puro markdown con wikilinks, así que Obsidian lo abre directamente y muestra el grafo; la documentación oficial no menciona automatizaciones ni sincronización más profundas, así que no esperes integración más allá de la de visor.

Límites de uso

• Acceso a archivos: la instalación y la ejecución crean y modifican archivos markdown en local (~/brain, raw/, directorios .claude); es el núcleo del flujo, no un efecto secundario opcional.
• Comandos y red: la evidencia oficial solo incluye el comando shell de instalación anterior; si el agente ejecuta otros comandos o accede a la red durante la ingesta no está aclarado, es desconocido.
• Puntos de confirmación: revisa tú mismo el material sensible antes de ponerlo en raw/; confirma antes de sobrescribir un ~/brain existente.
• Entorno de ejecución: se necesita una terminal local, git y un agente que lea archivos (la vía oficial principal usa Claude Code); Obsidian hace falta para ver la vista de grafo, pero no es una dependencia. La documentación oficial no lista otras restricciones de ejecución.
• Información clave sin confirmar: si la lista de agentes compatibles se limita a Claude Code (oficialmente solo dice que funciona con Claude Code y con cualquier agente que lea archivos), qué idiomas de texto soporta y qué otros comandos existen además de /ingest: no hay evidencia; antes de usarlo puedes revisar tú mismo los archivos reales en los directorios skills y commands para confirmarlo.