NeuTerminal

Gestor de tareas, recordatorios, checklists y notas interactivo para la terminal. Inspirado visualmente en herramientas modernas de terminal, pero sin inteligencia artificial y 100 % local: tus datos nunca salen de tu equipo.

╭──────────────────────────────────────────────────────────────╮
│  NEUTERMINAL                                                  │
│  🌐 Mi página web                                             │
│                                                              │
│  > ☐ Diseñar página principal                                 │
│      ☑ Crear navbar                                           │
│      ☐ Crear hero                                             │
│    ☐ Configurar base de datos                                 │
│    ☐ Comprar dominio                                          │
│                                                              │
│  ──────────────────────────────────────────────────────────  │
│  > _                                                          │
│  [V] Check  [F] Uncheck  [E] Edit  [B] Delete  [N] New        │
│  [Enter] Open   [↑↓] Navigate   [/] Commands   [Q] Quit       │
╰──────────────────────────────────────────────────────────────╯

Instalación

npm install -g neuterminal

Luego ejecútalo con cualquiera de los dos comandos:

neu           # atajo corto
neuterminal   # nombre completo

Requiere Node.js ≥ 20 y una terminal interactiva (TTY). Funciona en macOS, Linux y Windows. better-sqlite3 se instala con binarios precompilados para las plataformas habituales; si tu sistema no tiene binario, necesitarás las herramientas de compilación de C++ (build-essential / Xcode CLT / MSVC).

Primer inicio

La primera vez que ejecutes neu aparece un asistente que te pregunta:

1. Idioma (español / inglés).
2. Dónde guardar los datos (~/.neuterminal, ~/Documents/NeuTerminal, la ubicación estándar del sistema, o una ruta personalizada).
3. Tema (Ocean, Dark, Dracula, Nord, Minimal, Custom).
4. Emojis sí / no.
5. Mostrar los atajos sí / no.
6. Estilo de las casillas (☑ / ☐, [ ] / [x], ✓ / ○, ✔ / ☐, o personalizado).

Puedes reejecutar el asistente con /setup, o editar la configuración en cualquier momento con /settings (panel centrado con todos los ajustes: idioma, tema, estilo de casilla, borde, emojis, atajos, ubicación de datos…).

Notas y casillas

Cada elemento del árbol es un documento Markdown:

• La primera línea es el título; el resto es el cuerpo (Markdown), que se guarda tal cual.
• Por defecto un elemento es una nota de texto (viñeta ·).
• Si la primera línea empieza por [] (o [x]), el elemento pasa a ser una casilla marcable (☐ / ☑) y responde a V / F. Quita el [] para volver a convertirlo en nota.

El editor vive en la franja inferior, entre dos líneas ────, y crece con el texto hasta cubrir la navegación cuando el documento es largo.

Tiene dos modos que se alternan con Shift+Tab:

| Modo | Para qué | Enter | |---|---|---| | Casillas | añadir tareas rápido, una por línea | crea la siguiente tarea hermana | | Contenido | documento Markdown; 1ª línea = título (resaltado) | salto de línea |

• Esc = guardar y cerrar · Ctrl+S también guarda (sin cerrar)

Nota sobre Shift+Enter: la mayoría de las terminales no lo distinguen de Enter, por eso se usa Ctrl+S / Esc para guardar.

Las notas muestran a la derecha cuántas líneas contienen (título + cuerpo, 99+ a partir de 100) y no llevan viñeta. Las casillas muestran ☐ / ☑.

Navegación y atajos

| Tecla | Acción | |--------------|----------------------------------------------------| | ↑ ↓ | Moverse por los elementos | | → | Entrar en las subtareas del elemento seleccionado | | ← / Esc | Volver (sube un nivel; en la raíz, a proyectos) | | Enter / E| Abrir el panel de edición (título + cuerpo) | | Espacio | Desplegar / plegar un elemento con hijos | | V / F | Marcar / desmarcar (solo casillas) | | B | Borrar (pide confirmación) | | N | Nuevo elemento (hijo del contexto actual) | | I | Cambiar el icono | | Tab | Añadir una nota rápida (una línea) al documento | | / | Abrir la paleta de comandos | | Q | Salir |

La barra de atajos de la parte inferior cambia según el contexto y se acorta automáticamente si la terminal es estrecha.

Comandos /

Escribe / en el input inferior para abrir el autocompletado.

| Comando | Qué hace | |------------------------------|------------------------------------------------| | /new [título] | Crea una tarea (subtarea si estás dentro de una)| | /edit | Edita la tarea seleccionada | | /note <texto> | Añade una nota | | /check · /uncheck | Marca / desmarca | | /delete | Borra (con confirmación) | | /search [texto] | Busca en títulos y notas | | /project [nombre] | Cambia de proyecto o crea uno | | /theme | Cambia el tema | | /settings · /config | Panel de configuración (tema, casillas, ubicación…) | | /setup | Reejecuta el asistente de primer inicio | | /export [json\|markdown] | Exporta el proyecto actual a <datos>/exports/ | | /import <ruta> | Importa un .json o .md como proyecto nuevo | | /backup | Copia la base de datos a <datos>/backups/ | | /location | Muestra dónde se guardan los datos | | /help | Ayuda | | /quit | Salir |

Dónde se guardan los datos

Dentro de la carpeta que elegiste en el asistente:

<datos>/
  config.json        # tu configuración (tema, colores, iconos, idioma…)
  tasks.db           # base de datos SQLite con proyectos y tareas
  themes/            # temas (editables; añade los tuyos aquí)
  backups/           # copias de seguridad de tasks.db
  exports/           # exportaciones .json / .md

Un pequeño archivo puntero en la carpeta de configuración del sistema recuerda esa ubicación entre sesiones.

Temas y personalización

Los temas son archivos JSON en <datos>/themes/. Copia uno, cámbiale el name y ajusta los colores para crear el tuyo; aparecerá en /theme. También puedes sobrescribir colores puntuales desde config.json (colors.primary, etc.).

Tipografía

La fuente la define tu terminal, no la aplicación. NeuTerminal usa Unicode, emojis, negrita y atenuado, y detecta si tu terminal no soporta ciertos caracteres para caer a una alternativa ASCII ([x] / [ ]).

Desarrollo

npm install
npm run dev        # ejecuta desde el código fuente (tsx)
npm test           # tests (vitest)
npm run typecheck  # tsc --noEmit
npm run build      # genera dist/ (tsup)

Licencia

MIT