Go (requiere Go instalado)

June 28, 2026 · View on GitHub

Neuron CLI Logo

Neuron CLI

Tus notas son texto plano. ¿Por qué gestionarlas tiene que sentirse tan pesado?

Si te gusta Neuron CLI, ¡considera apoyarlo con una ⭐ en GitHub!

English | [Español]


Neuron es un gestor de notas local-first y compatible con Obsidian, diseñado para la terminal. Mantiene tu bóveda de Markdown exactamente donde está: sin migraciones, sin bases de datos propietarias y sin suscripciones en la nube. Solo acceso ultrarrápido y guiado por teclado a tus pensamientos desde cualquier parte de tu shell.

¿Por qué otro gestor de notas?

Si eres como yo, pasas el día en la terminal y guardas tus notas en archivos Markdown planos. Pero la mayoría de herramientas de notas se sienten demasiado pesadas: requieren interfaces llenas de clics, corren sobre frameworks Electron que consumen recursos, o intentan amarrar tus datos a una suscripción de sincronización en la nube.

Neuron está construido de otra manera:

  • Cero bloqueo de datos (Lock-in): Trabaja directamente con tu directorio local de archivos Markdown. Puedes abrirlos en Obsidian, VS Code o Vim en cualquier momento.
  • Velocidad sin fricciones: Abre, busca, crea y organiza notas en milisegundos usando atajos de teclado optimizados.
  • Listo para IA: Realiza consultas a tu bóveda usando inteligencia artificial local (vía Ollama) o expón tus notas a agentes de IA mediante el servidor integrado de Model Context Protocol (MCP).

¿Por qué Neuron? (Filosofía)

  • El teclado manda: Tus manos nunca deberían dejar la fila inicial del teclado (home row). Cada acción —desde buscar notas hasta mover carpetas y copiar bloques de código— está a un atajo de distancia.
  • Privacidad por defecto: Tus pensamientos son tuyos. Neuron funciona 100% offline. No te rastrea, no sube tus notas a internet y no requiere que crees una cuenta.
  • Libertad de formato: Creemos que Markdown plano con frontmatter YAML estándar es la mejor manera de ser dueño de tus notas. Si mañana decides dejar de usar Neuron, tus notas seguirán siendo simples archivos de texto legibles por cualquier editor.

Inicio Rápido

Ponte en marcha con solo tres comandos:

  1. Instala Neuron: 
    brew install steevin/tap/neuron
  2. Inicializa tu Bóveda: 
    neuron init
    Apunta Neuron a un directorio existente de Obsidian o crea una bóveda desde cero.
  3. Inicia la TUI: 
    neuron
    Presiona ? dentro de la interfaz para ver todos los atajos disponibles.

Instalación

Opciones detalladas para instalar Neuron:

# Homebrew (macOS y Linux)
brew install steevin/tap/neuron

# Binario mediante curl
curl -sSfL https://github.com/steevin/neuron-cli/releases/latest/download/neuron_$(uname -s)_$(uname -m).tar.gz | tar -xz -C /usr/local/bin neuron

# Go (requiere Go instalado)
go install github.com/steevin/neuron-cli@latest

# Desde el código fuente
git clone https://github.com/steevin/neuron-cli && cd neuron-cli && make build

Características

Organiza sin pensar (PARA)

Neuron entiende la metodología Projects · Areas · Resources · Archive (PARA) de manera nativa. Escanea las carpetas de tu bóveda y te ayuda a mantener el orden sin interrumpir tu flujo de trabajo:

  • Selector de carpetas inteligente: Al crear una nota (n o neuron add), un menú interactivo te pide elegir la carpeta de destino. Olvídate de acumular notas sueltas en la raíz de la bóveda.
  • Navegación fluida: Muévete entre carpetas usando ← → / h l o ↑ ↓ / j k. Presiona Enter para guardar o Esc para cancelar.
  • Movimiento rápido: Usa neuron move o el comando /move en la TUI para reubicar cualquier nota al instante.
  • Bóvedas planas: Si prefieres no usar el método PARA, el selector de carpetas se hace a un lado automáticamente.

Ubicación siempre visible (Breadcrumbs)

La barra de ruta (breadcrumbs) en la parte inferior de la TUI te muestra la ubicación exacta del archivo seleccionado (por ejemplo, 📂 1. Projects o 📂 2. Areas/Finance) mientras navegas por la lista.

Captura ideas al instante (Portapapeles)

  • Pegado instantáneo (ctrl+v): Presiona ctrl+v sobre cualquier nota de la lista para añadir el contenido de tu portapapeles directamente al final del archivo en el disco. Ideal para guardar fragmentos web o logs sin abrir un editor.
  • Gestión inteligente de recursos: Si tu portapapeles contiene la URL de una imagen o una ruta local, Neuron la copia a la carpeta de adjuntos configurada en Obsidian cuando exista, o a assets/ en caso contrario, y crea el enlace Markdown por ti. Las descargas remotas tienen un límite de 50 MiB.
  • Pegado en bloque (Bracketed Paste): Pega cualquier texto largo al ingresar el título de una nueva nota; Neuron usará la primera línea como título y el resto como contenido del archivo.

Búsqueda Dual

  • Búsqueda BM25: Búsqueda clásica por palabras clave que responde tan rápido como escribes.
  • Búsqueda Semántica / IA: Conecta Ollama en tu configuración para consultar tus notas por conceptos e ideas en lugar de palabras exactas (por ejemplo: neuron list -q "muestrame cosas relacionadas con mi presupuesto").

Plantillas que te ahorran teclear

No escribas el frontmatter a mano. Crea plantillas reutilizables y úsalas al vuelo:

neuron add "2025-06-01 Standup" --template standup
neuron today                                        # Crea automáticamente la nota diaria usando tu plantilla personalizada

Conecta tus ideas

  • Wikilinks al estilo Obsidian: Soporte completo para extracción e indexación de enlaces [[wikilink]].
  • Etiquetas: Los #tags dentro del texto de tus notas se indexan de forma automática para facilitar las búsquedas.
  • Resumen del Grafo: Presiona g en la TUI para ver al instante el recuento de notas (nodos) y conexiones (enlaces) de tu grafo de conocimiento.
  • Mantenimiento del grafo: Usa neuron backlinks, neuron orphan y neuron doctor para encontrar backlinks, notas aisladas y wikilinks rotos.

Mantén sana tu bóveda

  • Revisión Doctor: neuron doctor reporta cantidad de notas/tags, notas huérfanas, enlaces rotos, papelera, estado de Git, detección de Obsidian y conectividad de IA.
  • Timeline: neuron timeline muestra notas actualizadas recientemente, o historial de creación con --created.
  • Restaurar papelera: Las notas eliminadas van a .trash; usa neuron restore --list y neuron restore <nota> para recuperarlas.

Formularios interactivos

Si olvidas pasar algún parámetro en la consola, Neuron no fallará con un error críptico. Te guiará a través de bonitos formularios interactivos construidos con huh para crear notas, elegir carpetas o confirmar acciones.

Temas

Alterna entre los temas oscuro (Tokyo Night) y claro (GitHub) en tiempo real usando el comando /theme en la TUI, o configúralo de forma permanente en los ajustes.

Atajos de la TUI

Navega por Neuron rápidamente con estos atajos de teclado:

TeclaAcción
j / k o ↑ / ↓Navegar por la lista de notas
EnterSeleccionar / confirmar
Tab / Shift+TabCambiar el foco del panel (lista de notas ↔ previsualización)
nNueva nota (activa el selector de carpetas PARA)
eEditar la nota seleccionada en $EDITOR
ctrl+vPegar el contenido del portapapeles al final de la nota
c / yCopiar/extraer bloques de código de la nota seleccionada
/Abrir la paleta de comandos (búsqueda interactiva)
sSincronizar con Git
ctrl+gResumen del grafo de conocimiento
?Mostrar la ayuda de atajos
qSalir

Durante la selección de carpeta (modo 📁 SAVE TO)

TeclaAcción
← → / h l / ↑ ↓ / j kNavegar por las carpetas disponibles
EnterConfirmar la carpeta elegida
EscCancelar

Durante la extracción de código (modo 💻 COPY CODE)

TeclaAcción
← → / h l / ↑ ↓ / j kNavegar por los bloques de código
EnterCopiar el bloque seleccionado al portapapeles
EscCancelar

Paleta de comandos

Busca comandos en cualquier momento desde la TUI presionando /:

ComandoDescripción
/add <título>Crear una nueva nota (con selector de carpetas)
/todayAbrir o crear la nota diaria de hoy
/edit, /eAbrir la nota seleccionada en $EDITOR
/copy, /cCopiar la nota actual al portapapeles
/attach <ruta_o_url>Descargar o copiar un recurso y enlazarlo en la nota
/links, /lAbrir el primer enlace de la nota en tu navegador
/move <carpeta>Mover la nota seleccionada a una carpeta PARA
/rmEliminar la nota seleccionada
/sync, /sSincronizar con Git (pull y push opcional)
/statsMostrar estadísticas de la bóveda
/doctor, /healthMostrar salud rápida de la bóveda en la barra de estado
/backlinksMostrar backlinks de la nota seleccionada
/orphanMostrar conteo y ejemplos de notas huérfanas
/open, /oAbrir la bóveda en el explorador de archivos del sistema
/theme dark|lightCambiar el tema visual de la TUI en tiempo real
/quitSalir de Neuron

Uso de la CLI

Cada comando está pensado para ser rápido e intuitivo:

neuron                                   # Abre la TUI (comportamiento por defecto)
neuron init                              # Asistente de configuración inicial
neuron add                               # Solicita título y muestra selector de carpetas
neuron add "standup notes" --tag work    # Crea nota con etiqueta y luego pide la carpeta
neuron add "1. Projects/API redesign"    # Salta el selector usando una ruta explícita
neuron add "Config" --file nginx.conf --code # Crea una nota directamente desde un archivo externo
cat script.py | neuron add "Script" --code python # Crea una nota con código de una tubería (pipe)
neuron edit "standup notes"             # Abre la nota en tu `$EDITOR`
neuron today                             # Abre o crea la nota diaria de hoy
neuron list -q "kubernetes"              # Búsqueda semántica o por texto plano
neuron move "standup notes" projects    # Mueve una nota a tu carpeta de Proyectos
neuron attach "standup notes" ./img.png # Adjunta una imagen o archivo local a una nota
neuron links "standup notes"             # Extrae y abre enlaces o imágenes en el navegador
neuron backlinks "standup notes"         # Muestra notas que enlazan a una nota
neuron orphan                            # Lista notas sin enlaces ni backlinks
neuron timeline --created                # Timeline por fecha de creación
neuron restore --list                    # Lista notas en .trash
neuron restore "old note" --folder "4. Archive" # Restaura una nota eliminada
neuron doctor                            # Revisión de salud de la bóveda
neuron sync --pull                       # Sincroniza con git (pull + push)
neuron sync --remote backup              # Sincroniza usando un remoto Git por nombre
neuron sync --remote https://github.com/me/notes.git # Sincroniza usando una URL solo en esta ejecución
neuron stats                             # Recuento de notas y etiquetas
neuron config set editor "code -w"        # Cambia el editor predeterminado (soporta argumentos)
neuron config set theme dark             # Configura el tema permanente
neuron mcp                               # Inicia el servidor MCP

Las notas creadas o movidas con Neuron deben quedarse dentro de la bóveda configurada. Rutas relativas como ../fuera se rechazan para proteger tu sistema de archivos.

Integración con Agentes de IA (MCP)

Neuron expone tu bóveda de notas como un servidor Model Context Protocol (MCP). Puedes agregarlo a clientes de IA compatibles (como Claude Desktop, Cursor o Antigravity) para darles acceso a tus notas:

{
  "mcpServers": {
    "neuron": { "command": "neuron", "args": ["mcp"] }
  }
}

Una vez configurado, podrás pedirle a tu IA que busque, cree, resuma o mueva notas de tu bóveda sin necesidad de salir del chat.

Para dar acceso más seguro a agentes, ejecuta MCP en modo solo lectura o guarda una auditoría:

neuron mcp --read-only
neuron mcp --audit-log ~/.local/state/neuron/mcp-audit.jsonl

Formato de la Bóveda

Neuron utiliza Markdown puro con YAML frontmatter (exactamente igual que Obsidian). Apunta Neuron a tu directorio actual de Obsidian y funcionará de inmediato. Neuron también lee la carpeta de adjuntos de .obsidian/app.json al guardar archivos adjuntos.

---
title: Mi Nota
tags: [ideas, proyecto]
created: 2025-05-30T09:00:00Z
---

Contenido con [[wikilinks]] y #tags-internas.

Estructura PARA recomendada (Neuron autodetecta cualquier variante similar):

vault/
├── 1. Projects/
├── 2. Areas/
├── 3. Resources/
└── 4. Archive/

Actualización de Neuron

Mantén tu instalación actualizada al último release:

# Homebrew
brew upgrade steevin/tap/neuron

# Binario mediante curl
curl -sSfL https://github.com/steevin/neuron-cli/releases/latest/download/neuron_$(uname -s)_$(uname -m).tar.gz | tar -xz -C /usr/local/bin neuron

Apoyo al Proyecto

Crear y mantener herramientas de código abierto requiere tiempo y dedicación. Si Neuron hace que tu día a día en la terminal sea un poco más agradable, considera invitarme a un café o apoyar el desarrollo del proyecto: Apoyar el proyecto ➔

Licencia y Atribución

Neuron CLI es software libre bajo la licencia GNU GPL v3.

En pocas palabras:

  • Manténlo abierto: Si modificas y distribuyes este código, tu versión también debe ser de código abierto bajo la misma licencia GPL v3.
  • Da crédito: Por favor, mantén los avisos de copyright originales y la autoría de Daniel Steevin.
  • Muestra algo de cariño: Si utilizas partes de este proyecto en una bifurcación pública, añade una mención en el README apuntando hacia Neuron CLI. ¡Ayuda mucho a hacer crecer el proyecto!

Contacto

Para soporte, comentarios, consultas comerciales o cualquier otra duda, puedes escribirme a: neuron@steevin.com

Creado por Daniel Steevin
Distribuido bajo la Licencia GNU GPL v3 — Código abierto con Copyleft.