Inicio › Ayuda

Ayuda y funciones

Documentación completa de todo lo que hace LightNote — la misma ayuda que se abre en la app con la tecla F1. Usa el índice de abajo para ir a cualquier función.

✍️ Editor de código 🧠 Notas y segundo cerebro 🤖 Vibe coding (IA + MCP)

Ayuda de LightNote

Editor ligero de código y notas para Windows. La barra lateral lista las secciones y sigue lo que estás leyendo; los botones Inicio y Atrás en la parte superior de la ventana vuelven al principio, y el campo Buscar busca dentro del texto de esta ayuda (Enter avanza; F3 / Shift+F3 navegan). Pulsa F1 en cualquier momento para abrir esta ayuda justo en la sección de la pantalla actual.

Índice

Edición

Herramientas

Automatización (IA / scripts)

Referencia

Visión general

LightNote abre una carpeta como Espacio de trabajo y muestra el árbol de archivos a la izquierda, las pestañas de edición a la derecha y la barra de estado abajo. La franja pequeña en la parte superior de la barra lateral alterna entre las secciones Explorador (árbol), Buscar, Control de versiones (Git), Historial del archivo y Pendientes (TODO/FIXME y tareas de notas).

Además de código y notas, abre y edita muchos formatos en el lugar adecuado: tablas (Parquet/CSV/JSON con DuckDB y Excel .xlsx), PDF, imágenes (incluido GIF animado), .zip como carpeta, cuadernos de Bloques (.lnb), tableros de Tareas (.lnt), tablas personalizadas (.lnd), conexiones de base de datos (.lnc) y conexiones SSH (.lns). Hay una terminal integrada, búsqueda global (ripgrep), control de versiones Git simplificado, integración con CLIs de IA, un servidor MCP y una línea de comandos (lnote) para automatización.

¿Nuevo por aquí? El material de introducción (el espacio de trabajo de bienvenida) sigue disponible en cualquier momento en Ayuda → Reabrir el tour de bienvenida.

Espacio de trabajo y ventanas

La carpeta raíz abierta es tu Espacio de trabajo. Abrirla no crea nada; al cerrarla, LightNote solo escribe un pequeño archivo de sesión (pestañas abiertas y posición). El espacio de trabajo solo se convierte en un "proyecto" — con su propia configuración persistida — cuando habilitas el Control de versiones (Git) o el MCP en Herramientas → Ajustes del espacio de trabajo.

Los Ajustes generales se aplican a toda la aplicación; los Ajustes del espacio de trabajo solo a la carpeta abierta. La configuración y el estado viven en una base de datos central, no dispersos por la carpeta.

LightNote se ejecuta como instancia única: abrir una segunda carpeta reutiliza el proceso (multiventana, menos memoria). Hay un icono en la bandeja y un lanzador con un cuadro de búsqueda que lista los Espacios de trabajo (fija tus favoritos arriba con el menú contextual) — consulta Notas diarias y bandeja. Cada pestaña puede recibir una etiqueta de color mediante el menú contextual de la barra de pestañas. Para notas repetitivas, crea una carpeta Modelos (o Templates) con archivos .md y usa Archivo → Nueva nota a partir de plantilla…

Crear un archivo eligiendo el tipo. El menú Nuevo (☰ Archivo, el botón Nuevo de la barra de actividades o Crear nuevo en el menú contextual de una carpeta) ofrece Nueva nota (.md), Nuevo archivo de texto (.txt) y el submenú Nuevo archivo de código con los lenguajes más usados. En todos ellos el archivo se crea en el disco al instante con un nombre por omisión, y el árbol abre la edición del nombre: solo se preselecciona el nombre, así que escribir un título no borra la extensión. Para aceptar el nombre sugerido, basta con hacer clic en el editor y empezar a escribir. Para una extensión fuera del submenú, crea un archivo y renómbralo (F2): cambiar la extensión cambia la vista — renombrar .txt a .md vuelve a abrir la misma pestaña como nota, con vista previa y esquema, y al revés devuelve el editor de código. Las extensiones propias de LightNote (.lnc, .lne, .lnq, .lnh, .lns y los bundles) son la excepción: en ellas la extensión declara el formato del contenido, por lo que renombrar pide confirmación y se rechaza mientras la pestaña esté abierta.

Dónde se crea el archivo nuevo. Nuevo crea siempre en la carpeta marcada del Explorador, y siempre hay exactamente una marcada. En la parte superior del árbol está la fila de la carpeta raíz, con el nombre del espacio de trabajo: es un elemento como los demás — haz clic en ella para devolver el destino a la raíz. Seleccionar una carpeta mueve la marca a ella; seleccionar un archivo marca la carpeta que lo contiene. En el modo Lista, que no muestra carpetas, la marca queda en la fila raíz y esa fila muestra el destino efectivo. El menú contextual de la fila raíz ofrece Crear nuevo y Crear carpeta.

Para abrir un archivo suelto sin convertirlo en un espacio de trabajo, usa Abrir archivo suelto… (menú de la bandeja): la ventana independiente muestra el árbol de archivos, pero sin Git, MCP ni tema personalizado. Si se habilita en Ajustes → General → Funciones, LightNote se integra al menú del Explorador de Windows (por usuario, sin necesidad de administrador): además de la lista «Abrir con», el menú contextual gana «Abrir con LightNote» en cualquier archivo y «Abrir como espacio de trabajo de LightNote» en carpetas (en Windows 11, dentro de Mostrar más opciones). Los archivos se abren en esa ventana independiente; las carpetas, como espacio de trabajo.

Si seleccionas varios archivos a la vez en el Explorador de Windows — incluso de carpetas distintas — todos se abren en la misma ventana independiente, pestaña junto a pestaña (en vez de repartir una ventana por archivo). Las pestañas de esa ventana se recuerdan: al cerrarla y volver a abrirla, reaparecen los mismos archivos. Como aquí lo importante son las pestañas, el árbol de archivos empieza plegado: pulsa Ctrl+B (o el botón en la parte superior de la barra de actividad) para mostrarlo.

Volver a una sesión. La ventana de archivos sueltos se llama Archivos sueltos en todas partes, incluida la barra de título, donde las demás ventanas muestran el nombre del espacio de trabajo: así las distingues en Alt+Tab. En el menú de la bandeja, en Abrir, el elemento gana el sufijo (N pestañas) cuando hay pestañas guardadas; al pulsarlo vuelven todas. También es la primera fila del launcher, junto a los espacios de trabajo. Y al reabrir LightNote vuelve todo lo que estaba abierto cuando saliste: cada ventana en su carpeta, más la ventana suelta. Si prefieres abrir solo la última carpeta usada, cámbialo en Configuración → General → Interfaz → Al iniciar, abrir. Una ventana que cerraste antes de salir queda fuera: cerrar es la forma de decir "terminé con este espacio".

Favoritos: la barra lateral tiene una sección Favoritos con lo que hayas fijado (menú contextual del árbol o de una pestaña → Añadir a favoritos) y los archivos abiertos recientemente. Los fijados son por carpeta y se guardan como rutas relativas, así que sobreviven a mover el espacio de trabajo.

Abrir una pestaña en su propia ventana: en el menú contextual de la pestaña, Abrir en ventana nueva reabre ese archivo en una ventana independiente (útil para tener una nota junto al código). Los tipos que dependen del espacio de trabajo (.lnc, .lne, .lns y los bundles) no se pueden desacoplar.

Selección múltiple. El árbol acepta Ctrl+clic (individual) y Mayús+clic (intervalo) en los tres modos de vista. Con varios elementos seleccionados, el menú contextual actúa sobre toda la selección: Cortar y Copiar (interoperando con el Explorador de Windows), Eliminar (una sola confirmación para todos), Duplicar, Copiar hash, Comprimir en .zip (un solo archivo, cada elemento con su propio nombre en la raíz), Aplicar color, Favoritos, Git (add/restore) y Copiar rutas (una línea por elemento). Las acciones que solo tienen sentido para un elemento — renombrar en línea, Propiedades, Abrir como, Convertir — quedan deshabilitadas, con el motivo en la ayuda emergente. Hacer clic derecho dentro de la selección la conserva; hacer clic fuera selecciona solo el elemento pulsado. Seleccionar una carpeta y algo dentro de ella no repite la operación: el elemento interior se descarta.

Echar un vistazo sin abrir. Un clic simple en un archivo ya abre una pestaña de vista previa (reutilizada, en cursiva en la barra de pestañas). Al recorrer el árbol con las flechas, la tecla Espacio hace lo mismo y devuelve el foco al árbol, para seguir bajando por la lista.

Herramientas de archivo. El menú contextual del Explorador tiene el submenú Herramientas de archivo: Renombrar por lotes (filtro por extensión/comodín/regex + un pipeline de reglas con vista previa y detección de colisiones), Dividir archivo (por líneas, tamaño o separador regex), Unir archivos (manteniendo solo el 1.º encabezado CSV, opcional), Duplicar, Copiar hash (MD5/SHA-256) y Comprimir a .zip / Extraer aquí. Con varios elementos seleccionados, Renombrar por lotes y Unir archivos reciben exactamente los elementos elegidos (en lugar de recorrer la carpeta) — y Unir respeta el orden de la selección.

Navegación de la ventana suelta. Sobre el árbol hay atrás (Alt+←), adelante (Alt+→) y subir, más una ruta de carpetas pulsable — cada segmento lleva a ese nivel. Los botones laterales del ratón también retroceden y avanzan. Para escribir una ruta, haz clic en el espacio vacío de la franja o usa Ctrl+L; Esc cancela y vuelve a la ruta. Cambiar de pestaña también mueve la carpeta mostrada: como la ventana suelta reúne pestañas de carpetas distintas, hacer clic en una pestaña navega a su carpeta.

Menús. El botón ☰ (arriba en la barra de actividades) reúne los menús Archivo, Editar, Ver, Ventana, Herramientas, IA y Ayuda. Las acciones de IA tienen menú propio (también en el botón de la varita de la barra de actividades). En Herramientas, los grupos están en submenús: Ejecutar (F5/F6/F8, lint, enviar al terminal, macros), Capturar (nota de hoy, captura rápida, tarea rápida, grabar audio, notas adhesivas) y Espacio de trabajo (configuración, instantánea, exportar copia, mover carpeta) — este último también en el menú del engranaje. El menú Nuevo es el mismo en los tres lugares donde aparece: ☰ Archivo, el botón Nuevo y Crear nuevo en el menú contextual de una carpeta.

Editor de código

Los archivos de texto/código se abren en el editor (Scintilla) con resaltado de sintaxis. Hay comentar/descomentar (Ctrl+/), mover y duplicar línea, marcadores (Ctrl+F2), una lista de símbolos/funciones, autocompletado por palabras del documento, guías de sangría, ajuste de línea, zoom y detección de cambios del archivo en el disco. Con el control de versiones habilitado, el margen marca las líneas agregadas/modificadas desde la última versión.

También hay macros (graba/reproduce una secuencia de ediciones con Ctrl+Shift+R / F4, en Herramientas → Macros), formatear/embellecer (Shift+Alt+F), una tabla ASCII en la barra de herramientas de la pestaña (para insertar caracteres/dibujo de cajas) y un corrector ortográfico (Hunspell). pt-BR y en-US vienen integrados; los demás idiomas se descargan bajo demanda desde la tabla de Ajustes → Notas y escritura → Ortografía (una fila por idioma, con botón Descargar/Quitar). Para seguir un archivo de registro que se va escribiendo, usa el botón Monitorear (tail -f) en la barra de la propia pestaña. Los archivos muy grandes (por encima de ~1 MB) se abren en un editor ligero virtualizado que carga solo los fragmentos visibles; puedes forzarlo con Archivo → Abrir en el editor ligero…

Formatear y verificar (linters): Shift+Alt+F formatea el documento con el formateador externo del lenguaje (black, prettier, clang-format, gofmt, rustfmt…) cuando está instalado, recurriendo al formateador interno (JSON/XML) sin conexión; F7 ejecuta el linter del lenguaje (ruff, eslint, shellcheck, luacheck…) y marca los problemas con un subrayado en el editor y en el panel Problemas (panel inferior, navegable). Ambos tienen un catálogo con Agregar en Ajustes → Formato y → Linters, además de las opciones formatear al guardar / verificar al guardar. Ejecuta el archivo en el panel de salida con F6 (captura el código de salida y la duración, con detener/reiniciar) o solo un fragmento con F8.

Más funciones de edición: multicursor por ocurrencia (Ctrl+D, todas con Alt+F3), duplicar línea (Ctrl+Shift+D), unir líneas (Ctrl+Shift+J), expandir/reducir la selección por ámbito (Ctrl+Shift+Espacio / Ctrl+Alt+Espacio), selección rectangular (Alt+arrastrar), plegar/desplegar todo, fragmentos/snippets (Ctrl+J, editables en Ajustes → Editor), Ir al símbolo en el archivo (# en la paleta) y en el proyecto (Ctrl+T o ##), historial de navegación (Alt+←/→), una ruta de navegación (breadcrumbs) en la parte superior del editor, reglas de columna, coloreado de pares de paréntesis, cierre/envoltura automática de pares e higiene al guardar (recortar espacios, salto final) — todo en Ajustes → Editor.

Historial local y portapapeles: en cada guardado, LightNote conserva una versión del archivo (Archivo → Historial local…, restaurable), independiente de Git. Ctrl+Alt+V abre el historial del portapapeles para pegar un elemento copiado antes. Ctrl+Shift+T reabre la última pestaña cerrada; las pestañas se pueden fijar (menú contextual), lo que las protege de ser liberadas por inactividad.

Ir a la definición: F12 o Ctrl+clic sobre un identificador salta a donde está definido en el proyecto; Shift+F12 localiza sus usos.

Minimapa. Una miniatura de todo el documento aparece en el borde derecho del editor: muestra la “forma” del código (los colores del resaltado de sintaxis a escala reducida) y marca la región visible. Haga clic o arrastre sobre ella para ir a cualquier punto del archivo. Actívelo en Ver → Minimapa o en Configuración → Editor. El botón Minimapa de la barra de la propia pestaña de código (junto a ASCII) lo activa y desactiva sin salir del editor. En el borde izquierdo de la miniatura hay una franja de marcas: en azul las líneas con marcador (el mismo punto del margen) y en ámbar las coincidencias de la búsqueda rápida, para ver de un vistazo cómo se reparten por todo el archivo, incluso fuera de la pantalla.

Operaciones de texto. En el menú Editar — y en el menú contextual del editor — están los submenús Líneas (mover, duplicar, eliminar, ordenar, unir, invertir, numerar) y Limpieza (recortar espacios, quitar líneas vacías/duplicadas, tabulaciones ↔ espacios). Con una selección, el menú contextual ofrece además Guardar la selección como archivo nuevo…: escribe el fragmento en un archivo junto al actual y lo abre en una pestaña (el original no se modifica).

Markdown y wikilinks

Las notas .md se abren con editor y vista previa lado a lado (configurable). El marcado se atenúa fuera del párrafo del cursor para que la página parezca un documento terminado.

Atajos: Ctrl+B/Ctrl+I aplican negrita/cursiva y Ctrl+E alterna el modo de vista (edición → dividido → lectura).

Wikilinks: escribe [[ para autocompletar con las notas del espacio de trabajo; el enlace se cierra solo con ]]. Mantén Ctrl y haz clic en un [[nota]] para abrir la nota correspondiente. El panel Conexiones muestra los enlaces entre notas.

Vista previa enriquecida: los bloques de código entre vallas aparecen en una caja con la etiqueta del lenguaje y un enlace copiar; se representan ~~tachado~~ y ==resaltado==; y los callouts al estilo de GitHub (> [!NOTE], [!TIP], [!WARNING], [!IMPORTANT], [!CAUTION]) se convierten en cajas de color. Las etiquetas #hashtag se resaltan y, con Ctrl+clic, abren la búsqueda de esa etiqueta; el bloque de frontmatter YAML al principio (---) se resalta. En la barra de la pestaña hay un botón para exportar la nota como PDF/HTML, una columna de lectura centrada conmutable y los modos editor/ambos/vista previa. El modo Zen (F11) y el desplazamiento de máquina de escribir ayudan a escribir sin distracciones.

Novedades en la vista previa: además de ~~tachado~~ y ==resaltado==, funcionan superíndice ^x^, subíndice ~x~, emoji por atajo (:rocket:), autoenlace de URLs, notas al pie [^1], bloques plegables <details>, listas de definiciones, tareas - [ ]/- [x] (⬜/✅) y el token [TOC] (índice clicable en la vista previa); también imágenes locales y HTML en línea (<kbd>, <mark>…). El panel Índice (barra de la pestaña) recorre los encabezados siguiendo el cursor, y el botón Insertar (o el menú contextual → Formato/Insertar) aplica cualquier marcado.

Encabezados fijos (sticky scroll): al desplazarte, los encabezados que contienen la línea superior quedan fijados en una franja en la parte alta del editor; hacer clic en uno salta a esa sección (actívalo en Configuración → Markdown). El menú contextual de una carpeta en el árbol crea/abre la Nota de la carpeta (index.md con frontmatter), útil como índice.

Nota de carpeta y lista de archivos: hacer doble clic en una carpeta abre su index.md, si existe. Dentro de cualquier nota, el token [files] (o [arquivos]) solo en una línea se sustituye en la vista previa por la lista de los archivos de la carpeta de la nota, como enlaces clicables: generada al momento, sin escribir nada en el archivo (igual que [TOC]).

Operaciones de texto y de línea. Las operaciones del editor de código también valen en la nota — mediante el botón Texto de la barra de la pestaña, el menú contextual y los submenús Líneas y Limpieza del menú Editar: mover la línea (o las líneas seleccionadas) arriba/abajo (Ctrl+Shift+↑/↓), duplicar (Ctrl+Shift+D), eliminar (Ctrl+Shift+L), ordenar (A→Z / Z→A), invertir el orden, unir líneas, quitar líneas duplicadas o vacías, quitar espacios y mayúsculas/minúsculas (e invertir). Numerar líneas… abre un diálogo con inicio, paso, ceros a la izquierda y separador — con el valor por omisión (". ") el resultado es una lista numerada Markdown válida. Con una selección la operación actúa solo sobre ella (ampliada a líneas completas); sin selección, sobre todo el documento — siempre un único paso de deshacer. La barra de la pestaña trae además el botón IA (Preguntar / Editar con IA), el mismo Ctrl+K / Ctrl+I del código.

Encabezados plegables: haz clic en la flecha a la izquierda de un encabezado (o usa Ctrl+Shift+[ / Ctrl+Shift+]) para contraer y expandir la sección; en Ver están Contraer/Expandir todos los encabezados. El plegado es solo visual —nunca se escribe en el archivo— y LightNote lo recuerda entre sesiones. Saltar desde el Índice o desde la búsqueda al interior de una sección contraída la expande.

Propiedades de la nota: el panel lateral Propiedades muestra el frontmatter YAML como campos tipados (texto, número, fecha, casilla), con la caja Tipo arriba. Definir el tipo y las propiedades es lo que permite reunir las notas en una Base.

Grafo de conexiones

Herramientas › Grafo de conexiones (Ctrl+Alt+G) muestra todas las notas del espacio de trabajo como un grafo interactivo: cada nodo es una nota .md, cada línea un wikilink. Los nodos se acomodan solos (física animada) y se pueden arrastrar; al pasar el cursor se resaltan los vecinos y se atenúa el resto; al hacer clic se abre la nota. Desplázate para hacer zoom (los nombres aparecen al acercarte) y arrastra el fondo para desplazar la vista.

En la barra de la pestaña: filtro por nombre (atenúa las notas que no coinciden), un interruptor para las notas huérfanas (sin ningún enlace — mostradas en gris), controles de fuerza (repulsión, distancia y gravedad), ajustar el grafo a la ventana y volver a escanear las notas. Cuantas más conexiones tiene una nota, más grande es su nodo; cada carpeta de primer nivel recibe su propio color.

Tablas (Parquet, CSV, JSON, Excel)

Los archivos .parquet se abren como tabla; .csv, .tsv y .json se abren como texto, y el menú contextual del árbol ofrece Abrir como tabla. La lectura es paginada (bajo demanda) mediante DuckDB, con ordenación (haz clic en el encabezado) y filtrado empujados al motor. El botón Estructura muestra columnas, tipos, número de filas y, para Parquet, los row-groups y la compresión. La vista es de solo lectura.

La barra de SQL libre en la parte superior de la tabla acepta cualquier consulta DuckDB — la vista t representa el archivo abierto. Desde el menú contextual de una carpeta en el árbol, Abrir carpeta como tabla lee todos los archivos del mismo formato como una sola tabla; desde el menú de la tabla puedes exportar la vista actual (CSV/Parquet/JSON), y desde el menú del árbol, convertir un archivo tabular a otro formato. El SQL libre también está disponible en el comando query de la línea de comandos y en el MCP.

Las hojas de cálculo de Excel (.xlsx) se abren como una tabla de solo lectura con un selector de hojas — un lector ligero, sin necesidad de instalar Excel.

Copiar como. En el menú contextual de cualquier tabla de LightNote (Parquet/CSV/JSON, Excel, resultados SQL, Tareas, Bases), la opción Copiar como lleva la selección al portapapeles ya formateada. Tabla con formato (Teams, Outlook…) se pega como una tabla de verdad, con bordes y encabezado, en los programas que entienden texto enriquecido — Teams, Outlook, Word, Excel (donde no hay texto enriquecido, recurre automáticamente a TSV). Los demás se pegan como texto: tabla Markdown (lista para una nota), CSV (con comillas según la RFC 4180), TSV (separado por tabulaciones), HTML (el marcado <table>), JSON, JSONL (un registro por línea), YAML y el submenú Código, que genera un literal listo para pegar en un archivo fuente: Python (lista de diccionarios) o JavaScript / TypeScript (array de objetos). En JSON, YAML y código, las celdas que son números salen sin comillas — pero se conserva el texto original, así que IDs como 007 siguen siendo texto. Ctrl+C sigue copiando en TSV, como antes.

Todas las tablas se comportan igual: Ctrl+F enfoca el filtro rápido ("contiene en cualquier columna"), un contador muestra cuántas filas quedaron y hay Exportar a CSV — también en las hojas .xlsx, en las Tareas y en las Bases. El menú contextual de la cuadrícula sigue ofreciendo Copiar como.

Gráfico del resultado. La barra lateral de la tabla tiene un botón Gráfico (barras, línea o dispersión): la agregación se ejecuta en DuckDB (no sube ninguna fila cruda) y un botón Añadir a la nota del día guarda el gráfico como imagen. El panel Estructura incluye además un perfil por columna: un mini-histograma de las columnas numéricas y los valores más comunes de las demás.

PDF e imágenes

Los archivos .pdf se abren en un visor nativo (Qt6::Pdf, sin dependencias pesadas), renderizado en la CPU y sin WebEngine. Las imágenes se abren en la vista de imagen; los GIF animados se reproducen en la vista animada.

La barra de la pestaña ofrece cinco paneles laterales, uno cada vez: Índice (el sumario guardado en el propio archivo; cuando el PDF no lo trae, el botón queda desactivado y lo explica), Miniaturas (las páginas de un vistazo, renderizadas al desplazarte), Buscar, Enlaces y Propiedades (título, autor, fechas, tamaño de página y del archivo).

Buscar (Ctrl+F) recorre todo el documento: las coincidencias se resaltan en las páginas y se listan con el texto que las rodea, y F3 / Mayús+F3 pasan de una a otra. El barrido es progresivo, así que la lista crece mientras se recorre el documento.

El campo de página acepta el número o la etiqueta impresa: en un documento cuyo prefacio está numerado en romanos, escribir 1 lleva a la página impresa "1", no a la primera hoja. El botón de modo de página alterna entre desplazamiento continuo y una página a la vez.

Un PDF protegido con contraseña pide la contraseña al abrirlo (hasta tres intentos); cancelar simplemente no abre la pestaña. Dentro de la misma ejecución de LightNote no se vuelve a pedir: la aplicación reabre la pestaña por su cuenta cuando la libera por inactividad, y sería ella misma creando la molestia. Si marca "Recordar la contraseña de este archivo" en el propio aviso, también vale en las próximas ejecuciones: queda protegida por Windows (solo para usted, solo en este equipo), nunca va al Git ni a la nube y no se incluye en la exportación de configuración. Para borrarlas todas: Configuración → Funciones → Contraseñas de PDF. Un PDF protegido no se reabre solo al iniciar la aplicación: en vez de encadenar avisos de contraseña antes de mostrar la ventana, espera a que usted lo abra.

Desde el menú de acciones de la barra: copiar el texto de la página, exportar el texto de todo el documento, copiar o guardar la página como imagen y enviar la página a la nota del día. El panel Enlaces existe porque el componente PDF de Qt sigue por sí solo los enlaces internos, pero ignora los externos: es ahí donde se abre una dirección web, con confirmación.

Limitación: no hay selección de texto con el ratón, porque el componente PDF de Qt no la ofrece. Para llevarte el contenido, usa "copiar el texto de esta página" o la exportación del documento.

Imágenes: marcar una captura

Una imagen se abre en una pestaña con barra propia: además de girar, reflejar y ampliar, trae las herramientas de marcado — el camino de hacer una captura, señalar lo que importa y llevárselo a la documentación.

La herramienta inicial es Mover: arrastrar sigue moviendo la imagen, como siempre. Seleccionar elige una parte — arrastre para crearla, arrastre desde dentro para desplazarla y use los tiradores de las esquinas y los bordes para redimensionar; Esc deselecciona y Supr borra el contenido de la región. En el modo Mover, Shift+arrastrar también selecciona. En cualquier herramienta, el botón central del ratón mueve la imagen.

El Cuentagotas toma un color de la propia imagen: el botón izquierdo lo lleva al color del borde y el derecho al de relleno. Lee de la imagen ya marcada, así que también sirve para repetir el color de una marca recién hecha.

Las demás dibujan: Rectángulo, Elipse, Flecha, Línea, Resaltado (translúcido, como un marcador), Lápiz (trazo libre), Pincel, Paso numerado (que se numera solo — 1, 2, 3...), Texto, Difuminar y Foco (oscurece todo excepto la región elegida). Al dibujar, Shift fija cuadrados/círculos y ángulos de 45°.

Son dos colores, en dos botones: el del borde (que también es el del trazo y el de la etiqueta) y el de relleno, que puede ser ninguno. Sin relleno, el rectángulo y la elipse salen solo de contorno, y el paso numerado y el texto usan el color del borde como fondo, con la etiqueta en blanco o negro — el que contraste. Si elige un relleno, este pasa a ser el interior de la forma y el fondo de la etiqueta, y el borde pasa a ser el color del texto.

El Pincel pinta con el relleno, en una marca del tamaño del grosor — redonda o cuadrada, con el botón junto al grosor. Un solo clic ya deja la marca. Con el relleno blanco es la goma de borrar: tapa lo que haya debajo.

El grosor vale para el trazo, para el tamaño de la etiqueta y para el tamaño del bloque del difuminado; se atenúa en las herramientas que lo ignoran. El color y el grosor se recuerdan entre sesiones. Ctrl+Z y Ctrl+Y deshacen y rehacen las marcas, y Limpiar marcas las borra todas de una vez (también reversible).

Difuminar es para ocultar (un token, un correo, una ruta). Mientras la pestaña está abierta el marcado es reversible, pero al guardar o copiar los píxeles de esa región se destruyen de verdad: el archivo que sale no guarda el original en ninguna parte.

Tres operaciones tienen nombres parecidos y hacen cosas distintas. Cortar (Ctrl+X) copia la selección al portapapeles y borra la región, pintándola con el color de relleno (blanco cuando no hay) — y la selección se queda donde está, de modo que Pegar justo después devuelve la pieza exactamente al lugar de donde salió, flotando: así se mueve un trozo de la imagen. Supr es cortar sin copiar. En cambio Mantener solo la selección, en el menú Imagen, hace lo contrario: se queda con la región y tira el resto, cambiando el tamaño de la imagen.

El resto de la familia: Copiar lleva la imagen marcada o solo la selección; Pegar trae la imagen del portapapeles como un pegado flotante — muévalo y redimensiónelo con los mismos tiradores y haga clic fuera (o pulse Intro) para guardarlo, Esc lo descarta; y Ctrl+A (o Ctrl+T) selecciona toda la imagen. También están Guardar (escribe las marcas en el propio archivo), Guardar como... y Enviar a la nota del día, que guarda el PNG en Anexos/ e inserta el ![]() en la nota. Mientras haya marcas sin guardar la pestaña conserva el asterisco, y cerrarla pregunta si quiere guardar.

El botón Imagen reúne lo que actúa sobre la figura entera: girar, reflejar, redimensionar por porcentaje, reducir a 1600 / 1200 / 800 px de ancho (una captura nace demasiado grande para la documentación), recortar bordes de color uniforme, añadir margen, sombra paralela y grabar las marcas en la imagen — esto último convierte las marcas en píxeles al momento, que es lo que permite difuminar sobre una marca. Redimensionar lleva las marcas y el grosor del trazo consigo.

Para capturar la pantalla sin salir de LightNote: Capturar pantalla... en el menú de la bandeja (o Ctrl+Alt+P) congela el escritorio, arrastra para elegir el área (Esc cancela) y el recorte se abre en una pestaña nueva, listo para marcar.

Limitaciones: una marca ya dibujada no se mueve ni se edita — deshágala con Ctrl+Z y vuelva a hacerla; los GIF y WebP animados se abren en la vista de animación, que no tiene marcado; y un .svg se rasteriza al leerlo, así que guardar pide un destino en PNG.

Zip como carpeta (.zip)

Un .zip se abre en su propia pestaña: el árbol de miembros a la izquierda (nombre, tamaño, fecha) y el contenido del miembro seleccionado a la derecha — texto/código, Markdown (con vista previa), imagen o PDF — abierto en memoria, sin extraer nada al disco. El texto y el Markdown se pueden editar: Ctrl+S reescribe el miembro dentro del propio .zip.

La misma pestaña abre .7z, .rar, .tar (incluidos .tar.gz, .tar.bz2 y .tar.xz), .cab e .iso: en esos casos solo lectura, es decir se puede navegar, ver y extraer miembros, pero no editar. Solo el .zip es escribible, porque es el único formato que sabemos reescribir con seguridad (el .rar es propietario y ni las bibliotecas libres lo comprimen).

Las imágenes y los PDF son de solo lectura; los miembros muy grandes (y los .parquet) solo ofrecen Extraer a…. No se admite crear, renombrar ni eliminar miembros.

Los miembros protegidos con contraseña se leen con normalidad: al abrir uno, LightNote pide la contraseña (hasta tres intentos) y, si marca "Recordar la contraseña de este archivo", no vuelve a preguntar: en la misma ejecución por omisión, y también en las siguientes si marca la casilla (protegida por Windows, solo para usted en este equipo; bórrelas todas en Configuración → Funciones). Observe una diferencia del formato frente al PDF: en el .zip el cifrado es por miembro y el índice queda en texto claro, así que la lista de archivos se ve entera incluso sin la contraseña: solo el contenido está protegido. Un .zip con miembros cifrados no se reabre solo al iniciar la aplicación.

Bloques (.lnb)

Un paquete de Bloques es una carpeta cuyo nombre termina en .lnb, tratada como un único elemento en el árbol (doble clic para abrirla). Cada bloque es un archivo real en el disco; el orden vive en un blocks.json en la raíz del paquete. Funciona como un cuaderno: celdas apiladas de código o texto.

Cada celda tiene un nombre, un botón de tipo (define el intérprete/lexer) y botones para copiar, insertar, eliminar y ejecutar. Ejecutar hasta aquí ejecuta en secuencia todas las celdas de código hasta la actual; la salida (stdout+stderr) aparece en un panel justo debajo de la celda. Crea uno desde el árbol (Nuevo) o con Archivo → Nuevo.

Ctrl+Enter ejecuta la celda con el foco — el mismo gesto del editor SQL.

El resultado queda guardado (como en un cuaderno de laboratorio): al terminar, cada ejecución se convierte en un archivo .md dentro de saida/<celda>/, en el propio paquete — con el instante, el código de salida, la duración, el comando y la salida en sí. Al ser Markdown, se lee en cualquier editor, se versiona en Git junto al cuaderno y lo recupera Chat con IA. Al reabrir el paquete vuelve la franja Última ejecución encima del panel: haz clic en ella para ver el resultado sin volver a ejecutar.

Historial: el botón Historial junto a esa franja lista las ejecuciones anteriores de esa celda (instante y código de salida) — útil para comparar lo que devolvió la misma celda a lo largo del tiempo. Guardamos las 10 más recientes por celda; para cambiarlo, edita la clave historyLimit en el blocks.json del paquete (0 desactiva el guardado). La salida muy grande se recorta (el archivo indica truncated: true). Renombrar la celda o cambiar su tipo se lleva el historial consigo; eliminar la celda envía su historial a la Papelera.

Celda SQL contra una base de datos real: apunta el cuaderno a una conexión .lnc desde la franja superior (Elegir conexión…) y las celdas de tipo sql pasan a ejecutarse en la base de datos, no por un intérprete. El resultado de un SELECT se convierte en una tabla en el archivo de salida (Markdown real, que cualquier visor muestra formateado); INSERT/UPDATE y similares informan cuántas filas cambiaron, y un error de la base detiene el script y registra la instrucción que falló. Traemos hasta 100 filas por consulta (el archivo avisa cuando hay más) — el resultado es una anotación, no una copia de la tabla.

La conexión vive en blocks.json como ruta relativa, así que el cuaderno sigue funcionando al mover o sincronizar la carpeta. Si prefieres un cuaderno autocontenido, guarda el propio .lnc dentro del paquete: cuenta como configuración, no se convierte en celda. Es la misma conexión de la pestaña Base de Datos — conectar en un lugar vale en el otro, y la contraseña sigue las reglas de la Frase de paso. Sin conexión apuntada, la celda sql sigue ejecutándose por el intérprete configurado, como antes.

Tareas (Kanban / Gantt)

Un paquete de Tareas (.lnt) abre un tablero de tareas con vistas Kanban (columnas de estado, arrastra las tarjetas), Gantt (planificación basada en el esfuerzo) y calendario. Cada tarea puede tener un título, una columna (estado), un esfuerzo en horas y una nota .md asociada. Las tareas también son accesibles por la IA, mediante MCP y CLI (crear, mover, actualizar, leer/escribir la nota).

Campos por tarea: además del estado y el esfuerzo, cada tarea tiene una prioridad (colorea el borde de la tarjeta y ordena la Tabla), una fecha de vencimiento (chip rojo cuando está atrasada), varias etiquetas, una lista de comprobación de subtareas (insignia de progreso en la tarjeta) y recurrencia (completar una tarea recurrente genera la siguiente aparición). Edítalos desde el menú contextual (Tabla/Kanban) y en el panel Propiedades.

Captura y listas: la Tarea rápida de la bandeja entiende lenguaje natural (p. ej. Pay bill tomorrow 5pm #home !high; las palabras de fecha, hora y prioridad se reconocen en inglés y en portugués). El botón Plantillas guarda/aplica plantillas de tarea; Listas por vencimiento filtra Hoy/Próximos 7 días/Atrasadas; Vistas guardadas guarda filtro+orden; y la bandeja/Launcher muestran recordatorios de las tareas que vencen hoy o están atrasadas.

Tablero Kanban: puedes agrupar las columnas por estado, prioridad o etiqueta, crear carriles (swimlanes), definir límites de WIP por columna (el encabezado se pone rojo al excederse) y ordenar las tarjetas. Navegación con teclado al estilo Linear: ←/→ mueven el foco, Ctrl+←/→ mueven la tarjeta, N crea, Espacio completa/reabre y Supr elimina. También está la vista Calendario (por fecha de vencimiento).

Nota incrustada: al seleccionar una tarea se muestra su nota .md junto a las vistas (se guarda automáticamente al cambiar de tarea); el botón Nota activa/desactiva el editor y Abrir nota en una pestaña la abre en su propia pestaña. Archivar una tarea la oculta de todas las vistas; el conmutador Mostrar archivados revela las archivadas (atenuadas).

En Configuración de Tareas puedes definir Archivar tareas completadas tras N días: al abrir el tablero, las tareas que llevan más tiempo que eso en la última columna se archivan automáticamente (0 = desactivado).

La nota se abre incrustada de forma predeterminada (doble clic en la tarea) y se guarda sola mientras escribes: las Tareas nunca preguntan "¿guardar?" al cerrar. Dentro de la nota funcionan las acciones de IA (Ctrl+K / Ctrl+I).

Barra de la pestaña. Las acciones que dependen de la tarea seleccionada (Eliminar, Dependencias, Historial (Git)) y Exportar CSV están en el botón ⋮. El botón Vistas reúne las listas por vencimiento, las vistas guardadas y mostrar archivadas — todas actúan sobre la Tabla. Ctrl+F enfoca el filtro rápido y el contador de la derecha muestra cuántas tareas dejó el filtro.

Tabla personalizada (.lnd)

Una Tabla personalizada (.lnd, en Archivo → Nuevo) es tu mini base de datos: defines las columnas en tiempo de ejecución — texto, número, fecha, lista fija con colores, ruta, etiquetas y contraseña — y llenas las filas como una hoja de cálculo, con ordenación y filtrado. Un campo ruta agrupa las filas en un árbol (p. ej. Casa/Oficina).

Las celdas de contraseña se cifran individualmente con la Frase de paso y se revelan bajo demanda. Igual que las Tareas, el paquete se persiste como texto compatible con Git (NDJSON) — se puede versionar y fusionar entre máquinas.

En las columnas de texto, abrir una celda muestra un editor multilínea flotante: Enter inserta un salto de línea y Ctrl+Enter confirma; la cuadrícula muestra el texto en una sola línea (con …) y el contenido completo en la información sobre herramientas. Para cambiar el tipo de una columna, usa el menú del encabezado: convertir texto → contraseña cifra los valores con la Frase de paso; convertir contraseña → texto pide confirmación y el PIN/Frase de paso y escribe el contenido como texto sin formato (irreversible). Las demás conversiones conservan los valores.

Bases (consultas guardadas sobre las notas)

Una Base (.lnq, en Archivo → Nuevo → Nueva Base) es una consulta guardada sobre tus notas: filtra por tipo y por propiedades y ve el resultado como tabla o tablero. La Base no guarda ningún dato: las filas son tus notas .md y la fuente de verdad de cada celda es el frontmatter de la nota. Borrar un .lnq no pierde ninguna nota.

Editar la celda escribe en la nota. En la tabla, cambiar una propiedad reescribe solo esa línea del frontmatter del archivo. En el tablero, arrastrar una tarjeta de una columna a otra escribe el nuevo valor de la propiedad de agrupación (por ejemplo, pasar de leyendo a leído).

Cada nota declara sus propiedades en el frontmatter (type, status, autor…). Usa el panel lateral Propiedades de la nota para editarlas como campos tipados (texto, número, fecha, casilla) en lugar de YAML en crudo — ver Notas en Markdown.

El .lnq es NDJSON (un registro por línea), pensado para Git: dos máquinas pueden editar la misma Base en paralelo —una añade una columna, la otra ajusta un filtro— y la fusión conserva ambos cambios sin conflicto.

Esquema declarado (opcional). De forma predeterminada LightNote infiere los campos de cada tipo a partir de lo que las notas ya usan: no hace falta declarar nada. Cuando quiera fijar el esquema, abra Herramientas → Tipos de nota... (o el botón de engranaje de la mini-barra Propiedades de la nota): declare los campos de cada tipo, su tipo de dato (texto, número, fecha, casilla, lista de opciones) y una plantilla predeterminada. Con el esquema, un campo de lista de opciones se convierte en un desplegable con los valores permitidos, los campos declarados aparecen en los selectores de columna y filtro de la Base aunque ninguna nota los use todavía, y el botón Aplicar plantilla del tipo trae el esqueleto de la nota. El esquema vive en .lightnote/types.ndjson: NDJSON combinable, versionado en Git junto con las notas; borrarlo no altera ninguna nota, solo vuelve a la inferencia.

Buscar en archivos y Pendientes

Usa Ctrl+Shift+F para la búsqueda global en la pestaña Buscar de la barra lateral, impulsada por ripgrep: admite regex, distinción de mayúsculas, palabra completa y reemplazo masivo. Dentro del archivo actual, Ctrl+F busca y Ctrl+H reemplaza.

El resaltado y las marcas son cosas distintas. La búsqueda rápida (Ctrl+F) solo resalta las coincidencias en ámbar: es temporal y desaparece al cerrar la barra o vaciar el campo. En cambio, Marcar todo de Editar → Búsqueda avanzada… es una decisión tuya: pinta las coincidencias en rojo y añade el marcador (el punto azul del margen) en las líneas correspondientes, que permanecen hasta que uses Limpiar marcas. Ambos son independientes: cerrar la búsqueda rápida no borra lo que marcaste, y limpiar las marcas no borra el resaltado de la búsqueda. Los dos aparecen en la franja del minimapa, cada uno con su color.

La sección Pendientes de la barra lateral reúne en un solo lugar los marcadores TODO/FIXME del código y las tareas (- [ ]) de las notas Markdown del espacio de trabajo — haz clic para saltar directamente a la línea.

Control de versiones (Git fácil)

El control de versiones es opcional por espacio de trabajo. Habilítalo en Herramientas → Ajustes del espacio de trabajo: LightNote crea el repositorio Git (si aún no existe) y muestra la barra lateral de control de versiones (Ctrl+Shift+G).

En modo automático, LightNote guarda versiones (commits) por sí mismo en los momentos elegidos en los Ajustes generales (al guardar, al cerrar una pestaña o al cerrar la ventana). En modo manual, escribes el mensaje y guardas la versión en el panel. El indicador de la barra de estado muestra el estado (sin cambios, X modificados…) y, al hacer clic, abre los ajustes del espacio de trabajo. Puedes ver el diff de cada archivo y restaurar (descartar) los cambios sin guardar.

La automatización tiene 3 niveles por carpeta (en Ajustes del espacio de trabajo): Manual (nada automático), Commit automático (guarda versiones por sí mismo, pero no sincroniza) y Todo automático (hace commit y sincroniza — push tras el commit + pull periódico; requiere credenciales de Git sin preguntar). El panel muestra una línea de estado con ↑ por enviar / ↓ por recibir respecto al remoto, y el botón principal cambia de commit a Sincronizar cuando hay versiones por enviar — así queda claro que, después de guardar, aún falta sincronizar.

El panel Git y el menú Git del árbol ofrecen Agregar (git add) y Restaurar (git restore) por archivo, además de Comparar en paralelo (el archivo completo con la última versión).

Instantáneas y copia de seguridad

En el menú ⋯ del panel de control de versiones (o en Herramientas):

  • Crear instantánea: marca el estado actual con una etiqueta de fecha/hora para que puedas volver a él más adelante.
  • Restaurar instantánea: elige una instantánea y qué hacer — traer los archivos de vuelta conservando el historial (recomendado), retroceder el historial hasta ese punto, o abrirla como una copia aparte.
  • Exportar copia (.zip): comprime todo el espacio de trabajo en un archivo autónomo (con el marcador de proyecto incrustado) para enviarlo o guardarlo en otro lugar.
  • Mover carpeta del espacio de trabajo…: mueve la raíz en el disco y ajusta las rutas de la sesión y del registro.

Revisar cambios (puntos de control)

Herramientas → Revisar cambios… muestra, en una sola pestaña, el diff agregado de todo lo que cambió en el espacio de trabajo desde una base: la lista de archivos agregados/modificados/eliminados a la izquierda y el diff del archivo seleccionado a la derecha. Se diseñó para revisar lo que cambió una sesión de CLI de IA antes de aceptar el trabajo.

La base puede ser la última versión (HEAD) o un punto de control: crea uno antes de empezar una tarea (botón en la propia pestaña) y compara contra él después. Los puntos de control no crean commits y nunca tocan tu historial. Requiere el control de versiones habilitado para la carpeta.

Comentarios por lotes. Al revisar una sesión de IA, el botón Comentar (también en el menú contextual de la lista de archivos) anota un comentario sobre el archivo seleccionado — anclado al fragmento que marques. Los comentarios se acumulan en una lista y solo llegan al terminal de la CLI cuando pulsas Enviar a la sesión, todos en un único mensaje. Es deliberado: enviarlos de uno en uno hace que el agente arregle un problema y rompa otro, porque cada ronda no ve las demás críticas. Tras la revisión, los comentarios siguen en la lista para que compruebes si se atendieron; marca los resueltos y lo que quede entra en el siguiente envío. Si el agente reescribe la región comentada, el comentario se atenúa en vez de desaparecer. El envío se confirma en la barra de estado, y una sesión hibernada se reanuda automáticamente para recibir el lote.

Comparar archivos (diff)

Herramientas → Comparar dos archivos… abre ambos lado a lado (dos editores) y marca las diferencias línea por línea. La comparación es de solo lectura.

Los botones ◀ / ▶ (o F8 / Shift+F8) saltan al cambio anterior/siguiente. Desde el panel Git también puedes comparar un archivo en paralelo con la versión guardada (HEAD vs. disco).

Ejecutar código (F5)

Herramientas → Ejecutar archivo (F5) guarda el archivo actual y lo ejecuta en la terminal, según el intérprete registrado para la extensión. Los valores predeterminados cubren .py, .sh, .bat, .cmd y .sql; puedes editar/agregar intérpretes en Ajustes → Ejecución.

El comando es una plantilla con {file} (archivo), {folder} (carpeta) y {name} (nombre) — por ejemplo, para Python: python {file}. También puedes enviar solo la selección/línea actual a la terminal con Ctrl+Shift+Enter. En los Bloques, cada celda se ejecuta con el mismo mecanismo.

El botón Ejecutar tiene una flecha para elegir y recordar el terminal de destino cuando hay más de un terminal abierto.

Errores en los que se puede hacer clic. En el panel de salida (F6), las referencias a archivo:línea se convierten en enlaces: Ctrl+clic o doble clic abre el archivo en ese punto exacto. Funciona con trazas de Python, pilas de Node, errores de compilador (gcc/clang/MSVC) y salida de linters. Solo se convierte en enlace lo que existe realmente en el disco; el resto sigue siendo texto.

Recorrer los errores. En el panel de salida, F8 salta al siguiente error y Shift+F8 al anterior (también hay botones en la barra del panel). El salto es circular: desplaza la salida hasta la referencia, la resalta y abre el archivo en el punto exacto.

Terminal y CLIs de IA

Punto de estado por comando. Junto a cada comando ejecutado aparece un punto: azul si tuvo éxito, rojo si falló (el tooltip muestra la hora, la duración y el código de salida). LightNote lo activa automáticamente en PowerShell y Git Bash, sin cambiar tu configuración — actívalo o desactívalo en Configuración → Terminal → Integración de shell. Otros shells (cmd, WSL) o comandos personalizados no muestran el punto.

Abre una terminal integrada (emulador VT completo, vía ConPTY) con Ctrl+' (en la distribución de teclado de EE. UU., también Ctrl+`). Se convierte en una pestaña y se puede mover entre las áreas de la ventana. Los shells disponibles y las CLIs de IA detectadas en el PATH (p. ej. claude) son configurables en Ajustes → Terminal y Ajustes → Asistentes de IA. En el menú Nueva terminal, elegir una CLI de IA abre esa CLI como la terminal — la TUI/los colores aparecen normalmente, y salir de ella cierra la pestaña.

Programar un envío. En el menú contextual de la terminal (clic derecho), Programar envío… permite enviar un Enter (o un texto) más tarde — útil para reanudar una CLI de IA cuando se reinicia el límite de uso, sin estar pendiente. Elige el disparador: a una hora, después de unos minutos, cada intervalo (recurrente) o cuando la terminal quede inactiva. El equipo se mantiene despierto hasta el disparo. La programación dura mientras la pestaña de la terminal siga abierta.

Puedes tener varias programaciones a la vez. Cuando hay alguna, el elemento del menú muestra Envíos programados (N)… y abre un gestor: una tabla con la terminal, lo que se enviará, cuándo, y una cuenta regresiva en vivo hasta el próximo disparo, con botones Nuevo, Editar y Quitar. Mientras haya programaciones, un indicador de reloj con la cuenta aparece en la barra de estado (haz clic en él para abrir el gestor) y un pequeño reloj marca la pestaña de la terminal que está armada.

Aviso de fin de turno de la IA. Cuando una terminal de CLI de IA queda en silencio —señal de que el agente terminó su turno— LightNote te avisa: aparece un toast (haz clic para enfocar esa terminal) y la pestaña parpadea unas veces y mantiene un resalte hasta que la abras. Si la ventana está en segundo plano, su botón también parpadea en la barra de tareas. El aviso solo vale para terminales de CLI de IA y solo cuando la pestaña no tiene el foco. Actívalo/desactívalo y ajusta el tiempo de silencio en Ajustes → Terminal → Aviso de fin de turno de la IA.

Los terminales vuelven con la ventana. Al cerrar y reabrir el espacio de trabajo, los terminales de shell normal (Símbolo del sistema, PowerShell, Bash) se reabren — y en la carpeta en la que estabas, no en la que el terminal se abrió. El contenido de la pantalla no vuelve, pero el historial de comandos es del propio shell y sigue ahí: la flecha ↑ funciona con normalidad. Las sesiones de asistente de IA quedan fuera y se siguen ofreciendo aparte, porque un terminal nuevo no es la misma conversación. Tampoco vuelven las variables de entorno ni los entornos activados a mano en esa sesión (un venv, por ejemplo): el terminal se reabre en la carpeta correcta, pero es un shell nuevo.

Asistente de IA en la selección (Ctrl+K / Ctrl+I)

IA predeterminada. En la parte superior de Configuración → Asistentes de IA, la IA predeterminada elige el asistente usado por Ctrl+K/Ctrl+I, por el chat Chat con IA (que puede cambiar por sesión) y por las tareas automáticas (reescribir la pregunta, resumir, resumen de audio, generar contexto). Lista tanto las CLIs como los proveedores de API. La transcripción de audio y los embeddings tienen su propio proveedor, y LightNote sugiere un modelo según el proveedor elegido.

Pulsa Ctrl+K (Preguntar a la IA) o Ctrl+I (Editar con IA) en el editor — con o sin selección — para abrir un popup flotante estilo chat en línea: el campo de prompt viene rellenado con la selección debajo de una línea en blanco; escribe la instrucción encima y envía con Ctrl+Enter. En el popup eliges la IA (la predeterminada viene preseleccionada) y el modo de resultado: reemplazar la selección mediante un diff (Original × Sugerencia, con Aceptar / Copiar / Rechazar) o solo mostrar la respuesta como texto.

LightNote ejecuta la CLI de IA en modo "una pasada" (sin abrir una terminal). Las CLIs y la IA predeterminada viven en Ajustes → Asistentes de IA.

Modelos por API. Además de las CLIs locales, puede registrar modelos de LLM mediante una API compatible con OpenAI (OpenAI, Groq, DeepSeek, OpenRouter, Gemini, Anthropic, instancias locales como Ollama/LM Studio…) en Configuración → Asistentes de IA. Elija un proveedor del catálogo (con la URL lista), pegue la clave (guardada codificada solo en esta máquina), use Buscar modelos… y Probar. Los modelos registrados aparecen en el mismo selector de Ctrl+K, junto a las CLIs.

Conectar en un paso. El camino normal no es rellenar la tabla: en Configuración → Asistentes de IA, haz clic en Conectar una IA…, elige el proveedor (la lista señala cuáles tienen plan gratuito y cuáles se ejecutan en tu ordenador, sin clave), sigue los tres pasos, abre la página de claves con el botón y pega la clave. LightNote rellena la dirección y el modelo por su cuenta y prueba la conexión antes de guardar: una clave equivocada aparece ahí, no a mitad de una conversación. La lista de arriba muestra lo que ya está conectado y, en lo que falte algo, qué falta («falta pegar la clave», «falta elegir el modelo»); un doble clic reabre el asistente en ese proveedor.

Ajustes finos. Dirección, modelo, permiso de MCP, comandos de las CLI, transcripción de audio y embeddings siguen disponibles en Avanzado, al final de la página, y dentro del propio asistente, en Opciones avanzadas, puedes cambiar la URL base y el modelo antes de conectar. No se ha quitado nada: solo se ha apartado del camino de quien empieza.

¿Todavía sin ninguna IA? Al usar Ctrl+K sin ningún asistente conectado, LightNote lo explica y ofrece conectar uno en el momento — y en cuanto lo conectas, la acción que pediste continúa, sin repetir el atajo.

LLM local (sin clave). Los proveedores locales — Ollama, LM Studio, llama.cpp — no necesitan clave de API: elige uno en Añadir (el selector indica si el servidor está en ejecución) y usa Buscar modelos… para elegir entre los modelos que hayas descargado. Si Ollama no está instalado, LightNote se ofrece a instalarlo. Ya viene registrado en la primera ejecución: solo falta elegir el modelo. Como un modelo local puede tardar mucho más en responder (sobre todo en la primera generación, al cargar el modelo), LightNote espera mucho más por él que por un servicio en la nube. Ningún texto tuyo sale de la máquina.

Aceptar por bloque. Cuando el resultado llega como diff, no tienes que aceptarlo todo: cada bloque cambiado tiene una casilla para incluirlo o no, y el texto final se reconstruye solo con los bloques que conservas. El prompt también lleva contexto automático del archivo (ruta, lenguaje y las líneas alrededor de la selección), para que la IA responda con más precisión sin que pegues nada.

Biblioteca de prompts. IA → Biblioteca de prompts… guarda prompts reutilizables como archivos .md en una carpeta Prompts/ de tu espacio de trabajo: formato abierto, versionable en Git y parte de tu segundo cerebro. El selector trae búsqueda, vista previa y un botón para crear un prompt nuevo. Al elegir uno, los campos {selection}, {file}, {folder}, {name} y {language} se rellenan con el contexto del editor actual (tus propias variables se conservan), y el texto se inyecta en el campo de Ctrl+K o se envía a la terminal de IA activa, sin enviarlo.

No solo en el editor de código. Las acciones de IA (Ctrl+K / Ctrl+I y el menú contextual) también funcionan en el editor de Markdown, en la nota incrustada de las Tareas y en el editor de consultas SQL de la base de datos: en cada uno el popup se abre sobre el cursor y aplica el resultado en el sitio.

Todas las acciones de IA están en el menú IA (en el botón ☰ y en el botón de la varita de la barra de actividades): Preguntar a la IA (Ctrl+K), Editar con IA (Ctrl+I), Sesiones de IA, Chat con IA, Biblioteca de prompts, Generar el archivo de contexto del proyecto, Activar la IA en esta carpeta y Configurar los asistentes de IA.

Sesiones de IA

IA → Sesiones de IA… abre un cockpit que lista, con una tarjeta por sesión, cada terminal de CLI de IA abierto en cualquier ventana de LightNote — con un punto de color del estado, el nombre de la CLI, la ventana y distintivos para lo que necesita atención (envíos programados, copia aislada). El doble clic enfoca el terminal; el menú ⋯ de la tarjeta (o el botón derecho) ofrece Revisar los cambios de esa sesión (abre la pantalla de revisión con la base en el checkpoint creado cuando empezó la sesión — véase Revisar cambios) y Programar un envío. Es la forma de seguir varias sesiones de "vibe coding" a la vez sin perderte entre ventanas.

Al abrir una CLI de IA como terminal dentro de un repositorio Git, LightNote guarda automáticamente un checkpoint (con la etiqueta "Sesión …"), para que luego puedas ver y revertir exactamente lo que esa sesión cambió. La función se puede desactivar en Configuración → General → Funciones.

Copia aislada (worktree): en carpetas con Git, LightNote puede ejecutar el asistente de IA en una copia aislada de la carpeta (una rama propia), sin alterar los archivos que editas a mano. La primera vez pregunta; después es automático (se activa/desactiva por carpeta en Configuración del Espacio de Trabajo → Integraciones). Un distintivo copia aislada marca la sesión (la rama y la ruta están en la ayuda emergente), y los elementos Fusionar… (trae los cambios a tu carpeta — si tienes cambios pendientes, pregunta antes) y Descartar… (desecha la copia y la rama) cierran el ciclo.

Aviso de sesión inactiva. Cuando una CLI de IA queda inactiva (terminó o te está esperando), LightNote muestra una notificación; al hacer clic se abre la revisión de los cambios de esa sesión. Así puedes iniciar la tarea y alejarte. Se puede desactivar en Configuración → Terminal.

Archivo de contexto del proyecto. Al abrir una CLI de IA en una carpeta sin un archivo de contexto (CLAUDE.md o AGENTS.md), LightNote ofrece generar uno — y puedes hacerlo en cualquier momento desde Herramientas → Generar archivo de contexto del proyecto…. Un buen archivo de contexto describe la estructura y las convenciones del proyecto y ayuda a la IA a cometer menos errores, sin que reexpliques todo en cada sesión. Si hay un proveedor de IA configurado, él genera el contenido; si no, obtienes un esqueleto para completar.

Hibernar sesiones inactivas. Una CLI de IA parada sigue ocupando memoria (la conversación y el cliente del modelo). En Configuración → Terminal puedes definir un tiempo de silencio tras el cual LightNote termina el proceso y lo reanuda solo cuando vuelves a esa pestaña — el historial del terminal sigue en pantalla. Viene activado, con 30 minutos — tres sesiones paradas de Claude Code ocupaban más de 1 GB en la medición — y solo vale para sesiones en copia aislada cuyas CLI saben reanudar la conversación de la carpeta (hoy Claude Code y Antigravity), porque de otro modo la reanudación traería la conversación de otra sesión. Una sesión con un envío programado nunca hiberna. Y lo que vuelve es la conversación, no la pantalla de la herramienta: un texto escrito y aún no enviado se pierde.

Pestaña Actividad. La tabla muestra lo que se está ejecutando ahora; la pestaña Actividad guarda el historial: cada vez que un agente terminó su turno, empezó en una copia aislada o hibernó, con la fecha y un fragmento de la última respuesta. Los elementos no leídos aparecen en negrita y el recuento también sale en el menú de la bandeja — así quien se alejó del ordenador ve lo que se perdió, ya que las notificaciones son pasajeras. Abrir la pestaña marca todo como leído; un doble clic lleva de vuelta a la sesión. El cierre de la sesión también se registra — incluso cuando la CLI sale por su cuenta —, así una sesión que murió mientras no estabas deja rastro en vez de desaparecer. Si la sesión del evento ya no está abierta, el doble clic lo dice en lugar de no hacer nada.

Chat con IA

IA → Chat con IA… abre un chat que responde usando tus propias notas como contexto. En vez de enviar todo a la nube, LightNote recupera localmente los fragmentos más relevantes de tu vault (mediante ripgrep, sin embeddings ni servicio externo), arma la pregunta con esos fragmentos y la envía a un proveedor de IA por API que hayas registrado. La respuesta llega con las notas de origen como citas en las que se puede hacer clic — haz clic para abrir la nota. Ideal para "conversar con tu segundo cerebro" y reencontrar lo que ya anotaste. El historial de la conversación queda solo en memoria (no se guarda); la función se puede desactivar en Configuración → General → Funciones.

La ventana. Los selectores están en una única barra superior: la IA, la carpeta de notas y —cuando hay un editor de texto activo— el contexto; a la derecha quedan los dos permisos (Herramientas y Permitir cambios) y el botón +, que inicia una conversación nueva. Antes de la primera pregunta, la pantalla dice sobre qué responderá la ventana y ofrece atajos de un clic, como Resumir esta carpeta. En el campo de pregunta, Intro envía y Mayús+Intro hace un salto de línea; mientras llega la respuesta, el botón de envío se convierte en Detener.

Dejar que la IA use herramientas. La casilla Permitir cambios cambia el funcionamiento: en vez de responder solo con los fragmentos que recuperó la búsqueda por términos, el modelo puede buscar por su cuenta — leer un archivo, buscar notas, listar tareas — y recién entonces responder. Al activarla, LightNote comprueba en el momento si el modelo elegido sabe llamar herramientas: muchos proveedores aceptan la petición y simplemente las ignoran, lo que sin esa comprobación daría una respuesta inventada con aire de consultada. El veredicto se recuerda siete días por cada par proveedor+modelo. Requiere un proveedor por API (una CLI local no puede recibir herramientas). Al final aparece la lista de lo que se usó realmente, para que juzgues la respuesta en vez de confiar en ella. Si el veredicto es negativo — el proveedor pudo haber estado caído en ese momento —, aparece un botón Comprobar de nuevo junto al mensaje, que repite la prueba ignorando lo guardado.

Dejar que la IA modifique tus cosas. La segunda casilla, Permitir cambios, es un paso aparte y viene desactivada. Con ella, la IA también puede crear notas y tareas, cambiar propiedades y anotar en la nota del día — pero nada ocurre sin tu confirmación: el cambio aparece en la conversación en palabras claras («crear la tarea Comprar pan»), con Permitir y Rechazar. Rechazar no termina la conversación; se le avisa al modelo y sigue explicando o proponiendo otra cosa. Leer nunca pide confirmación — solo modificar. Quedan fuera, a propósito, sobrescribir archivos cualesquiera y acceder a la red: mientras la IA solo lee, un texto malintencionado que llegue en una nota sincronizada desde fuera no puede convertirse en un cambio en tu disco. Cuando el cambio es una anotación en la nota del día, la petición también indica en qué carpeta va a caer: es la única escritura cuyo archivo de destino no está en lo que pidió la IA.

Notas o el archivo abierto. El combo Contexto:, en la parte superior de la ventana, elige de qué trata la conversación: Notas del vault (lo predeterminado, descrito abajo) o Editor actual — que responde sobre el archivo abierto en el editor en lugar del vault, usando la selección y las líneas de alrededor (o el archivo completo, con la casilla Archivo completo). Así la misma ventana sirve para hablar de sus notas y del código que está editando, en varios turnos. El ámbito Editor actual solo aparece cuando hay un editor de texto activo. Y en el asistente rápido (Ctrl+K), el resultado trae un botón Continuar en el chat → que reabre esta ventana ya en el ámbito Editor actual, con la pregunta y la respuesta de esa ronda — para profundizar sin empezar de cero.

¿Qué notas? La ventana es única y responde sobre una carpeta a la vez — el combo Notas de:, junto al selector de IA en la barra superior, muestra y elige cuál. Se abre ya apuntando a la carpeta de la ventana desde la que abrió el chat y lista las carpetas abiertas ahora, seguidas de las recientes; Elegir carpeta… apunta a cualquier otra. Cambiar de carpeta vale para las preguntas siguientes — incluso para preguntar a las notas de un proyecto mientras trabaja en otro. Elegida a mano, la carpeta sigue valiendo hasta que la cambie de nuevo (reabrir la ventana no devuelve el alcance). Mientras una pregunta está en curso — incluso detenida esperando tu confirmación —, los selectores de IA, de contexto y de carpeta quedan bloqueados: la respuesta que viene pertenece al modelo y a la carpeta de cuando preguntaste.

Cómo preguntar. La recuperación es por asunto, no por instrucción: LightNote toma las palabras de tu pregunta y busca las notas que las contienen. Menciona un tema que aparezca en las notas ("¿qué anoté sobre Postgres?") en vez de una petición genérica ("haz un resumen") — esta última no tiene ninguna palabra de contenido que buscar, así que no se recupera nada y el chat avisa de que la respuesta no usó tus notas. Solo se leen notas .md/.markdown; en una carpeta sin ninguna, el chat lo indica y no gasta una llamada de IA.

Mejor búsqueda, resumen y reescritura. La recuperación usa un índice local con ranking BM25 que ignora los acentos ("configuração" encuentra "configuracao") y también funciona en idiomas sin espacios entre palabras (japonés, chino, coreano) — ripgrep es el respaldo mientras se construye el índice. El botón Resumir esta carpeta genera un panorama de todas tus notas cuando no tienes una pregunta concreta. Y en Configuración → General → Funciones, la opción Reescribir la pregunta con IA amplía tu pregunta en palabras clave antes de buscar (cuesta una llamada de API por pregunta).

Basta con una clave. En la primera ejecución, LightNote ya deja OpenAI, Google Gemini y Anthropic (Claude) registrados en Ajustes → Asistentes de IA: solo falta pegar tu clave de API en el proveedor que uses. Si ningún proveedor tiene clave, la ventana muestra un botón Configurar ahora que abre esa pantalla directamente.

Las conversaciones se guardan. El botón de reloj en la parte superior abre la lista de conversaciones anteriores de esa carpeta: haga clic en una para volver a ella. Nueva conversación archiva la actual en lugar de borrarla, y el botón derecho en la lista elimina una conversación definitivamente (con confirmación). Las conversaciones se guardan por carpeta: cambiar la carpeta de notas cambia la lista.

Qué hacer con una respuesta. Bajo cada respuesta hay Copiar (pone el texto en Markdown en el portapapeles, con el formato intacto) y Capturar en la nota (envía la respuesta a la nota del día, junto con enlaces a las notas citadas). En el menú Acciones de la conversación están Copiar conversación, Guardar conversación como nota… (guarda un .md en la carpeta consultada), Rehacer última respuesta y Editar última pregunta.

Adjuntar un archivo. Cuando la búsqueda no encuentra lo que tenía en mente, use el botón + para adjuntar un archivo: siempre entra en la pregunta, fuera de la competencia de la búsqueda. Sirve nota, código, texto y PDF (el texto del PDF se extrae); un binario se rechaza de inmediato en lugar de convertirse en ruido en el contexto. El adjunto aparece como una píldora (haga clic para quitarlo) y desaparece al empezar una conversación nueva. En los proveedores compatibles, la respuesta también va apareciendo poco a poco, mientras el modelo escribe.

Probar APIs HTTP (.lnh)

Herramientas → Nueva prueba de API (.lnh)… abre un cliente HTTP guardado en un archivo .lnh. Un archivo representa un endpoint (método, URL, cabeceras y cuerpo) y mantiene varias pruebas en la lista de la izquierda — cada prueba con sus valores para las variables {nombre} usadas en la URL, las cabeceras y el cuerpo, más el resultado de la última ejecución (estado, tiempo, fecha, cabeceras y cuerpo de la respuesta). También muestra el comando curl equivalente. La misma operación puntual está disponible vía CLI (http) y MCP (http_request).

Ctrl+Enter envía la petición.

Importar y exportar OpenAPI. El botón de flechas en la parte superior de la lista de pruebas abre Importar OpenAPI… y Exportar OpenAPI…. La importación lee una especificación en YAML o JSON en las tres generaciones en uso — Swagger 2.0, OpenAPI 3.0 y 3.1 — y arma la prueba sola: los {parámetros} de la ruta ya usan la misma sintaxis que las variables {nombre} del .lnh, los ejemplos declarados pasan a ser los valores de la prueba, el esquema de seguridad se convierte en la cabecera Authorization y cada servidor declarado se convierte en una prueba propia (homologación y producción lado a lado). Como un .lnh guarda un endpoint, una especificación con varias operaciones pregunta cuál importar — o guarda todas a la vez, un archivo .lnh por operación.

La exportación hace el camino inverso y genera una especificación OpenAPI 3.0.3 a partir del archivo: servidores, parámetros y cuerpo salen de la plantilla, y las respuestas de ejemplo salen de las ejecuciones registradas. Es un esqueleto, no un contrato completo — el .lnh describe llamadas, así que tipos, descripciones y esquemas no se reconstruyen. Sus pruebas viajan en el campo x-lightnote-tests, y por eso vuelven intactas al reimportar el archivo.

Importar un comando curl. En el mismo botón, Importar comando curl… abre un cuadro para pegar — de ahí viene el comando, no del disco, y el campo ya viene relleno cuando hay un curl en el portapapeles. Entiende los tres dialectos en los que circula el mismo comando: el de Copiar como cURL de Chrome/Firefox (comillas simples), el de Copy as cURL (cmd) en Windows (con ^) y el ejemplo de documentación cortado con \. El método sale del -X — o se deduce: POST cuando hay cuerpo, GET cuando no.

La importación es literal: ningún valor se convierte solo en una variable {nombre}, porque adivinar qué token es un secreto fallaría. Algunos casos avisan en vez de mentir — un cuerpo que viene de un archivo (-d @archivo) no se puede leer, y el envío multipart (-F) no se reproduce fielmente, así que los campos van al cuerpo como texto para que los ajuste.

Bases de datos (.lnc)

Una conexión es un archivo .lnc (LightNote Connection) dentro del propio espacio de trabajo — versionable en Git y portable entre máquinas. Crea una con Nuevo → Nueva conexión (o abre un .lnc existente): esto abre la vista de Base de datos, con la barra de estado de la conexión (Conectar / Desconectar / Reconectar / Editar), el árbol de Esquema (esquemas → tablas → columnas, cargado bajo demanda) y pestañas internas .sql. Los archivos .sql abiertos y los recientes se guardan dentro del .lnc, de modo que la vista se reabre en su estado anterior. Si no había nada abierto, comienza con una consulta vacía (sin título) donde puedes escribir SQL de inmediato; al guardar (Ctrl+S) LightNote pide solo un nombre y escribe el archivo dentro de la carpeta del proyecto (sin diálogo de "guardar en cualquier lugar"). El botón + Pestaña abre una nueva consulta vacía, te permite abrir un archivo (el selector se abre en la carpeta del proyecto) o elegir un .sql reciente / cualquiera de la carpeta del proyecto.

Un .sql abierto directamente desde el árbol es solo código (resaltado SQL, sin conexión).

Controladores: SQLite y DuckDB (archivo) nativos; PostgreSQL, MySQL/MariaDB, SQL Server y genérico vía ODBC; Oracle nativo (sin ODBC). SQL Server usa el controlador msodbcsql de Microsoft (instálalo en la máquina) y ofrece autenticación de Windows o usuario/contraseña, además de las opciones de cifrado del canal (Encrypt / confiar en el certificado). Para Oracle, define la carpeta del Oracle Instant Client en Ajustes generales → Base de datos — se carga en tiempo de ejecución, sin nada que instalar. La conexión Oracle tiene cuatro modos: Service Name (host/puerto/service), SID (host/puerto/SID), Nombre TNS (alias del tnsnames.ora de la carpeta del cliente) y Descriptor TNS completo (pegado en un campo de texto).

Contraseña: marca Guardar contraseña para cifrarla dentro del propio .lnc (cripto portable, se abre en otra máquina); sin marcar, la contraseña no se guarda y se pide en cada conexión. El cifrado usa una Frase de paso por espacio de trabajo, definida en Ayuda → Configurar Frase de paso; consérvala bien — sin ella la contraseña no se puede abrir en ningún otro sitio. La Frase de paso se guarda en caché solo en la máquina local (nunca va a Git).

Marca Conectar al abrir para que la conexión se abra automáticamente al abrir el .lnc. La conexión automática es silenciosa: si hay que escribir la contraseña (modo preguntar, o cifrada sin la Frase de paso en caché en la máquina), el archivo se abre desconectado, sin interrumpir.

Ejecutar: Ctrl+Enter ejecuta la instrucción bajo el cursor y Alt+X ejecuta el script entero; los resultados aparecen paginados, cada uno en una pestaña Resultado con una barra de acciones abajo: Obtener el siguiente bloque o todas las filas, Recuento total, cambiar el Límite de filas, Actualizar (vuelve a ejecutar), Ver/Copiar SQL, Exportar... y Generar SQL de la fila seleccionada.

Cuadrícula de resultados: un NULL se muestra en cursiva atenuada, distinto de un texto vacío, y los números se alinean a la derecha; al seleccionar varias celdas, el pie muestra el recuento de la selección y, cuando son numéricas, su suma y su promedio. El botón Panel de valor de la barra inferior (o Ver valor en el panel del menú contextual) abre un panel lateral con el valor completo de la celda seleccionada, sin recortar, con un botón Formatear que embellece JSON/XML solo en la visualización. En el menú contextual de una celda, Filtrar por este valor / Excluir este valor reejecutan la consulta con un WHERE por la celda, e Ir al registro referenciado sigue la clave foránea de la columna y consulta la tabla padre por el valor de la celda.

Plan de ejecución: el botón Plan de ejecución de la barra de herramientas muestra el EXPLAIN de la instrucción bajo el cursor (SQLite, DuckDB, PostgreSQL y MySQL); en las bases de datos que no exponen el plan en una sola instrucción (SQL Server, Oracle) el botón queda deshabilitado, con el motivo en su información.

Propiedades del objeto: haga doble clic en una tabla del árbol de esquema (o pulse F4, o elija Propiedades en el menú contextual) para abrir una pestaña con la estructura del objeto, en cuatro subpestañas: Columnas (n.º, nombre, tipo, si admite nulos, valor predeterminado y un icono de clave en las columnas de la clave primaria), Claves (primarias, foráneas, únicas y checks; al hacer doble clic en una clave foránea se abre la tabla referenciada), Índices y DDL — el CREATE TABLE del objeto, listo para copiar, guardar como .sql o abrir en una pestaña editable. Cuando la base de datos no proporciona el DDL ya hecho (PostgreSQL y SQL Server no tienen ese comando), LightNote lo reconstruye a partir de los metadatos — lo mismo ocurre cuando el comando de DDL se deniega por falta de permiso — y lo indica claramente en la pestaña. Si ni siquiera el catálogo de columnas se puede leer (sin permiso o catálogo no disponible), no hay de qué reconstruir: la pestaña lo avisa en vez de quedarse vacía en silencio. El menú contextual de la tabla también ofrece Copiar DDL sin abrir la pestaña.

Árbol de esquema: el árbol de Esquema separa Tablas de Vistas (cada una con su icono) y marca con un icono de clave las columnas de la clave primaria. La caja de filtro solo criba entre los objetos ya cargados (la carga bajo demanda no se fuerza solo para filtrar).

Explorar el esquema: Haz clic derecho en una tabla para Insertar SELECT en el editor, Ver datos, Contar filas, Copiar nombre cualificado o abrir el submenú Generar SQL → INSERT/UPDATE/MERGE: una pantalla lista las columnas de la tabla para que marques Incluir y Clave, muestra una vista previa en vivo e inserta el comando en el editor (MERGE sale en ANSI; si el controlador no lo admite, aparece un aviso). En la propia cuadrícula de resultados, el botón Generar SQL de la barra inferior construye un INSERT/UPDATE/DELETE prerellenado con los valores de la fila seleccionada (disponible cuando la consulta es un SELECT de una sola tabla). Los nombres de tablas y columnas que exploras en el árbol también empiezan a aparecer en el autocompletado (Ctrl+Espacio) de los editores .sql de la conexión, sin consultas adicionales a la base de datos.

Exportar resultados: haz clic derecho en la cuadrícula de resultados y elige Exportar resultado... para escribir CSV (delimitador, carácter de comilla, entrecomillar siempre, fila de encabezado, texto NULL), JSON Lines o SQL (instrucciones INSERT con un nombre de tabla), con un límite de filas opcional. La exportación recorre la consulta completa en modo streaming (re-obtención paginada), no solo lo visible en pantalla.

Variables de script: usa @set nombre = valor en una línea del script para definir una variable — el prefijo @ la mantiene alejada de la base de datos (no choca con el SET real de Postgres/DuckDB/SQL Server). Las referencias como :nombre se sustituyen antes de ejecutar (fuera de cadenas y comentarios; el cast ::tipo y los binds como :1 quedan intactos); un :nombre sin valor abre un prompt antes de ejecutar. El botón Variables de la barra de herramientas abre la pantalla con las variables definidas (editar/agregar/quitar).

Historial de consultas: el botón Historial abre una ventana con las últimas instrucciones ejecutadas con éxito en esta conexión, en columnas SQL / Cuándo / Duración / Filas. Selecciona una para Volver a ejecutar, Insertar en el editor o Copiar (doble clic inserta), o usa Borrar historial. Se guarda solo en la máquina local (no va ni a Git ni al .lnc).

Transacciones: el botón Autocommit (activado por defecto) y los botones Commit/Rollback viven en la barra de herramientas. Con el autocommit desactivado, los cambios quedan pendientes hasta que confirmes (Commit) o descartes (Rollback); desconectar con una transacción abierta pregunta qué hacer.

Conexión SSH (.lns)

Una conexión SSH es un archivo .lns en el espacio de trabajo — versionable y portable, como el .lnc. Crea una con Nuevo → Nueva conexión SSH: la pestaña abre una terminal SSH integrada (a través del ssh.exe de Windows) y una mini-barra de archivos remotos (SFTP).

El navegador de archivos muestra una carpeta a la vez (estilo MobaXterm/WinSCP): la primera fila siempre es .. para subir un nivel, y el doble clic en una carpeta entra en ella. La barra de ruta de arriba te permite escribir una ruta remota y pulsar Enter para ir allí. El botón Sincronizar con la terminal hace que la carpeta mostrada siga el directorio actual de la sesión SSH (donde sea que hayas hecho cd en la terminal). El menú contextual ofrece Abrir en el editor (descarga el archivo, lo abre en una pestaña y lo vuelve a subir al guardar), Descargar, Subir, Nueva carpeta, Renombrar, Eliminar y Permisos (chmod). También puedes arrastrar archivos desde el Explorador al panel para subirlos a la carpeta actual.

La contraseña se puede cifrar dentro del .lns con la Frase de paso del espacio de trabajo o pedirse en cada conexión. Las claves SSH del agente/perfil de Windows funcionan con normalidad, ya que la conexión usa el cliente OpenSSH del sistema.

La opción Conectar al abrir (en el diálogo de conexión) inicia la sesión SSH automáticamente al abrir el .lns. Si la contraseña no está guardada, la propia terminal la pide al conectar.

Seguridad: Frase de paso, PIN y Markdown seguro

La Frase de paso se define por espacio de trabajo en Ayuda → Configurar Frase de paso… y es la clave de todo lo que LightNote cifra: contraseñas de conexión (.lnc/.lns), celdas de contraseña de la Tabla personalizada y archivos .lne. El cifrado es fuerte y portable (Argon2id + XChaCha20-Poly1305): un archivo cifrado se abre en otra máquina una vez que vuelves a introducir allí la misma Frase de paso. Consérvala bien: sin ella, los datos cifrados no se pueden recuperar. La Frase de paso se guarda en caché solo en la máquina local (nunca va a Git).

Para cambiar la Frase de paso, abre la misma pantalla y edita el campo de la Frase de paso (viene rellenado con la actual). Al confirmar, LightNote vuelve a cifrar automáticamente todos los datos seguros del espacio de trabajo — contraseñas en .lnc/.lns, el contenido de los archivos .lne y las celdas de contraseña de las Tablas personalizadas (.lnd) — de la Frase de paso antigua a la nueva. El descifrado es todo o nada: si un solo elemento no se puede descifrar, no se cambia nada y LightNote te dice cuál. Durante la escritura, cada archivo se copia a una copia de seguridad antes de reescribirse; si uno falla al escribir, LightNote pregunta si deshacer todo (restaurar las copias) o omitir ese archivo y continuar (conserva la Frase antigua, con un aviso al final). (Las contraseñas en modo "preguntar" no tienen nada que volver a cifrar.)

El PIN (4–8 dígitos) es un bloqueo local opcional: protege acciones sensibles de la UI (revelar contraseñas, abrir notas seguras) sin escribir la Frase de paso cada vez. No cifra nada y se aplica solo a esta máquina.

El archivo Markdown seguro (.lne, en Nuevo → Archivo Markdown seguro) es una nota cifrada en el disco: al abrirla, LightNote pide el PIN (si está definido) y la Frase de paso, descifra solo en memoria y vuelve a cifrar al guardar (Ctrl+S). Por seguridad, nunca se reabre por sí mismo cuando se restaura la sesión.

Notas diarias, captura rápida y bandeja

La nota de hoy es un .md por día en la carpeta Notas diarias — una sola carpeta, válida para todo LightNote, definida en Ajustes → Notas y escritura. Desde el menú de la bandeja: Nota de hoy abre la nota del día; Captura rápida… (Ctrl+Alt+N, un atajo global de Windows — o clic central en el icono de la bandeja) abre una ventana pequeña donde escribes y pulsas Ctrl+Enter: el texto se convierte en una viñeta con marca de tiempo en la nota de hoy, escrita directamente en el disco, sin abrir una ventana del editor.

El menú de la bandeja también lista las ventanas abiertas y los espacios de trabajo recientes, y lleva los interruptores de energía: Mantener el equipo activo y Mantener la pantalla encendida (útiles para tareas largas; LightNote ya mantiene la energía por sí mismo mientras ejecuta IA de una pasada, celdas de Bloques o scripts SQL). El lanzador (ventana de inicio) tiene búsqueda, doble clic para abrir y un menú contextual para fijar arriba, abrir en el Explorador o quitar de la lista.

Las acciones que valen para todo LightNote — y no solo para la ventana en la que estás — viven en el menú General (☰ General, o el botón con el icono de la app en la barra de actividades), que tiene exactamente la misma forma que el menú de la bandeja: en la raíz Nota de hoy, Captura rápida y Calendario; luego los submenús Capturar (tarea rápida, grabar audio, reencontrar notas antiguas, notas adhesivas), Abrir (launcher, abrir espacio de trabajo, abrir archivo suelto, archivos sueltos) y Energía; al final, Configuración general. La regla es simple: lo que está en el menú de la bandeja está en el menú General — y solo ahí. Al pasar el ratón por un elemento aparece el aviso “función general: vale para todo LightNote, en cualquier ventana”.

Adónde va la captura. Las notas diarias y las tareas rápidas tienen un destino único y previsible: la carpeta definida en Ajustes → Notas y escritura y el tablero definido en Ajustes → General, válidos en cualquier ventana. En la primera captura, si no hay nada definido, LightNote pregunta dónde guardarla y registra la elección — en vez de mandarte a buscar la configuración. Un proyecto que necesite su propio diario (un cliente con confidencialidad, un registro que deba vivir en el repositorio) puede reclamar las capturas hechas en esa ventana en Configuración del espacio de trabajo → Capturas; la bandeja y los atajos globales siguen escribiendo en el destino general. El aviso de confirmación siempre dice adónde fue el texto.

El menú de la bandeja es corto a propósito: en la raíz quedan las ventanas abiertas y las tres acciones diarias — Nota de hoy, Captura rápida y Calendario. El resto vive en los mismos submenús del menú General: Capturar, Abrir (que en la bandeja trae además la lista de espacios recientes), IA (sesiones de IA y preguntar a las notas — en la ventana eso es el menú IA completo) y Energía. Al final, configuración y salir.

Reencontrar notas antiguas

Lo que más hace fracasar a un «segundo cerebro» no es la falta de una función, sino la nota que nunca se vuelve a leer. Desde el menú de la bandeja (sección Capturar), LightNote trae de vuelta notas antiguas: Nota aleatoria abre una nota .md al azar del espacio de trabajo (evitando las que aparecieron en las últimas dos semanas), y En este día lista las notas cuyo aniversario de creación es hoy (mismo día y mes, en años anteriores). Ambas acciones están también en el menú General → Capturar de la ventana.

La fecha de creación viene del campo created/date del frontmatter, si existe; si no, de la fecha del archivo. La función nunca escribe en tus notas: solo las abre. Se puede desactivar en Configuración → Recursos («Reencontrar notas antiguas»).

Tus notas en el móvil

Tu espacio de trabajo es Markdown puro en una carpeta — formatos abiertos, sin base de datos propietaria ni nube obligatoria. Por eso cualquier app de móvil lee y edita tus notas, sin que LightNote necesite una aplicación propia para el teléfono: basta con sincronizar la carpeta con un servicio de archivos y abrirla en un editor de Markdown en el móvil.

Paso a paso: sincroniza la carpeta del espacio de trabajo con OneDrive, Google Drive, Dropbox o Syncthing y, en el móvil, abre esa carpeta en un editor de Markdown (por ejemplo Obsidian Mobile, iA Writer, GitJournal o Markor). Como todo es .md en texto, ambos lados ven y escriben las mismas notas.

Recomendaciones: en el móvil, edita solo archivos .md — los tipos propios de LightNote (.lne seguro, .lnc, .lnt, .lnb, .lnd…) no se abren fuera de la aplicación, y el .lne en particular está cifrado. Si ambos lados editan sin conexión y hay conflicto, resuélvelo mediante la carpeta Inbox: deja ahí la captura (texto, audio o foto) y deja que LightNote la integre en la nota del día, en vez de sobrescribir. La ubicación es deliberada — la sincronización es por archivos/Git, no por plugins: tú eres dueño de tus datos y eliges el transporte. Para escribir directamente en la nota de hoy, edita el archivo Notas diarias/aaaa-mm-dd.md — el nombre de la carpeta cambia según el idioma.

Grabar audio (voz, reunión) con transcripción por IA

Desde el menú de la bandeja, Grabar audio… abre una ventana flotante y arrastrable (arrástrala por la barra de título) para grabar del micrófono, del audio del sistema (lo que suena en el equipo) o de ambos a la vez — la fuente elegida se recuerda para la próxima vez. Usa ● Grabar, ‖ Pausar y ■ Detener; el archivo va a la carpeta Grabaciones del espacio de trabajo, comprimido a .m4a al detener.

Dos maneras de transcribir. En Configuración → Asistentes de IA → Transcripción de audio, el selector Cómo transcribir elige entre el modelo de transcripción dedicado (estilo Whisper: OpenAI whisper-1, Groq whisper-large-v3 — gratis — o un Whisper local) y el modelo general con audio en el chat — el audio va dentro de la conversación de un modelo multimodal, que es como transcribe Google Gemini (gemini-2.0-flash, buen plan gratuito). Cambiar el proveedor preselecciona el modo correcto y sugiere el modelo; los audios largos se trocean automáticamente en cualquier modo. El modelo sugerido se puede cambiar a mano — LightNote respeta el id que escribas, incluso para un proveedor que aún no reconozca.

Al empezar a grabar, la ventana se colapsa sola en una píldora compacta (un punto rojo parpadeante, un cronómetro, Pausar/Detener) — fácil de arrastrar a una esquina y casi ocultar durante una reunión larga; el botón de minimizar/expandir en el título alterna manualmente, y detener la grabación la expande de nuevo. Ctrl+Alt+R (atajo global) es la nota de voz rápida: pulsa para empezar a grabar del micrófono al instante, pulsa de nuevo para detener, sin abrir la ventana con el ratón.

Si hay un proveedor de IA por API configurado (en Configuración → Asistentes de IA → Transcripción de audio), aparecen los botones Transcribir y Transcribir + Resumir al detener (deshabilitados mientras el audio aún se está comprimiendo); el combo Al detener dispara la transcripción sola en cuanto termina la grabación. LightNote envía el audio para su transcripción (modelo estilo Whisper) y guarda una nota .md junto al audio con el texto y, opcionalmente, un resumen. Activa/desactiva la función en Configuración → General → Funciones.

La misma ventana es un minirreproductor: debajo de los controles, una lista de grabaciones de la carpeta muestra cada archivo con botones T (abrir la transcripción) y R (abrir el resumen) cuando ya existen, además de un ▶ para reproducir allí mismo (barra de progreso con avance); el menú ⋮ de cada fila reproduce, (re)transcribe o abre la nota. Regenerar una transcripción no sobrescribe la anterior: crea una nueva versión al lado (nota.md, nota (2).md…), conservando el historial. La fuente de captura es un botón de menú (Micrófono / Audio del sistema / Ambos), con Ambos por defecto. El enlace Abrir carpeta de grabaciones abre la carpeta en la ventana principal.

Notas adhesivas

Las notas adhesivas son pequeñas cajas de texto sin formato y de colores que flotan sobre el escritorio, al estilo de la app Notas rápidas de Windows. Desde el menú de la bandeja: Nueva nota adhesiva (Ctrl+Alt+S, un atajo global) crea una caja; Mostrar notas adhesivas (Ctrl+Alt+H) las muestra u oculta todas a la vez. Cada nota tiene un + para crear otra y un menú ☰ para cambiar el color, Enviar a la nota de hoy (escribe el texto como una viñeta en la nota de hoy y descarta la caja) o Eliminar. Arrastra el encabezado para mover y la esquina para redimensionar. Las notas se guardan automáticamente y reaparecen al volver a abrir LightNote.

Calendario

General → Calendario… abre una única ventana con un calendario que marca los días que tienen tareas de todos los tableros .lnt registrados. Al lado, la lista Del día (tareas del día seleccionado) y la lista Pendientes; el botón Nota del día abre la nota diaria de esa fecha. Al hacer clic en una tarea se abre el tablero correspondiente.

En la cuadrícula, cada día con tareas recibe puntos de color con el color del estado del Kanban (hasta tres), el día de hoy se marca con un anillo y el día seleccionado con un círculo relleno; Hoy vuelve al mes actual y el nombre del mes abre un menú para saltar de mes o de año. Las Pendientes se agrupan por situación — Atrasadas, Hoy, Próximos 7 días, Después y Sin fecha —, con el vencimiento en un distintivo relativo («ayer», «hoy», «hace 3 días»). Un doble clic en un día abre la tarea rápida ya con esa fecha.

Paleta de comandos

Ctrl+Shift+P abre la paleta de comandos (cada acción con su atajo, filtrable al escribir). Ctrl+P abre el selector rápido de archivos y Ctrl+Shift+K abre el selector de tareas.

Servidor MCP (agentes de IA)

LightNote incluye un servidor MCP (Model Context Protocol) sin interfaz que convierte tu espacio de trabajo en una herramienta para agentes de IA (Claude Desktop, Claude Code, Cursor, y cualquier cliente que hable MCP). El agente puede leer y escribir archivos, buscar, consultar datos tabulares y bases de datos, trabajar con las tareas, usar Git y lanzar solicitudes HTTP — todo confinado a la carpeta (directory jail: las rutas con .. o fuera de la raíz se rechazan). El transporte es JSON-RPC 2.0 sobre stdin/stdout; cada sesión levanta un proceso lnote.exe ligero, aparte de la ventana del editor.

Atajo de un clic: en IA → Activar la IA en esta carpeta, LightNote habilita el MCP y escribe el .mcp.json de una vez (el clic es el consentimiento). Si la IA ya está activa en la carpeta, el elemento pasa a Configurar la IA de esta carpeta… y abre los Ajustes del espacio de trabajo.

Seguridad en dos capas: (1) el servidor solo arranca si has dado el consentimiento para esa carpeta; (2) toda herramienta está atada a la raíz del espacio. Además, cada herramienta se anuncia con anotaciones (solo lectura, destructiva, idempotente, "toca el mundo externo") para que el cliente de IA evalúe el riesgo antes de llamarla.

Configuración paso a paso

  1. Habilita el MCP en la carpeta. En Herramientas → Ajustes del espacio de trabajo, marca Habilitar MCP para este espacio de trabajo. Sin este consentimiento el servidor se niega a arrancar (es la traba principal). Como alternativa, desde la línea de comandos: lnote --mcp-enable "C:\Ruta\al\espacio-de-trabajo" (y --mcp-disable para desactivarlo).
  2. Localiza la ruta de lnote.exe. Está en la misma carpeta que lightnote.exe (la carpeta de instalación de la aplicación). Es el ejecutable de consola "slim", sin interfaz — es lo que ejecuta el agente.
  3. Registra el servidor en tu cliente de IA, apuntando el comando a lnote.exe y pasando --mcp seguido de la carpeta del espacio. En el formato que usan Claude Desktop / Cursor y similares:
{
  "mcpServers": {
    "lightnote": {
      "command": "C:\\Ruta\\a\\lnote.exe",
      "args": ["--mcp", "C:\\Ruta\\al\\espacio-de-trabajo"]
    }
  }
}

Consejos de configuración:

  • Las barras invertidas en JSON deben duplicarse (C:\\Users\\...\\lnote.exe), como en el ejemplo.
  • Para exponer varios espacios de trabajo, añade una entrada por carpeta, con nombres distintos ("lightnote-proyectoA", "lightnote-proyectoB"), cada una apuntando a su raíz.
  • Tras guardar la configuración, reinicia el cliente de IA para que levante el servidor. Al conectar, el agente debería listar las herramientas lightnote_*; pídele "lista los archivos del espacio" para confirmar que funciona.
  • Para Claude Code (CLI), el mismo servidor se registra con claude mcp add lightnote -- "C:\Ruta\a\lnote.exe" --mcp "C:\Ruta\al\espacio-de-trabajo".

Contraseña de base de datos (opcional). La herramienta db_query abre una conexión .lnc. Si la contraseña está cifrada con la Frase-Segura, pásala mediante la variable de entorno LNOTE_PASSPHRASE en el bloque del servidor (nunca en argumentos de línea de comandos) — las conexiones cuya contraseña está en modo "preguntar" no pueden usarse de forma desatendida.

Las consultas de IA son opcionales por conexión. Activar el MCP en la carpeta no expone las conexiones: cada .lnc solo responde a db_query cuando la opción «Permitir consultas de IA (MCP)» está marcada en el diálogo de la conexión. El acceso es de solo lectura (SELECT).

Exportar desde la base de datos con el agente. Ademas de consultar, el agente puede materializar un SELECT en un archivo con db_export (Parquet, CSV, JSON o .xlsx) — util para resultados demasiado grandes para caber en la respuesta. Rigen las mismas tres precauciones, en este orden: la consulta debe ser de solo lectura, la conexion necesita la opcion «Permitir consultas por IA (MCP)» (comprobada antes de descifrar la contraseña) y el destino debe quedar dentro del espacio de trabajo. Las exportaciones grandes usan la carpeta temporal del sistema como area de apoyo, aproximadamente del tamaño del resultado — deje espacio libre en disco.

Herramientas disponibles

El agente ve las herramientas bajo el prefijo del cliente (p. ej. lightnote_read_file). Por categoría:

  • Archivos: read_file (con rango de líneas opcional), write_file, edit_file (reemplaza un fragmento exacto, sin reescribir el archivo entero), append_file, list_files, move_file, make_dir y delete_file (va a la Papelera de reciclaje, no borra del todo).
  • Búsqueda y navegación: search_files (ripgrep, con filtro de subcarpeta/glob y límite), list_symbols (esquema de las funciones/clases de un archivo) y open_in_editor (abre/enfoca un archivo en la ventana de LightNote, si está abierta).
  • Datos y SQL: query (SQL DuckDB sobre Parquet/CSV/JSON, salida tsv/json/markdown), describe_table (esquema + estadísticas, sin volcar filas), export_query (materializa un SELECT en un archivo vía COPY), sqlite_query (SQL en un .sqlite/.db), db_list_connections (lista los .lnc del espacio) y db_query (SQL de solo lectura en una conexión .lnc). Para llevar el resultado a un archivo en vez de la respuesta, db_export (Parquet/CSV/JSON/.xlsx).
  • Además: search_notes (recupera los fragmentos más relevantes de las notas para una pregunta — el mismo motor de Preguntar a tus notas), list_links (los enlaces de salida de una nota, resueltos o rotos), audit_vault_links (enlaces rotos y notas huérfanas de todo el depósito), list_note_templates y el parámetro template de create_note, list_due_tasks (tareas que vencen hoy o atrasadas en todos los proyectos), xlsx_read (lee una hoja .xlsx como TSV), data_diff (compara dos archivos tabulares) y el catálogo de la base de datos db_list_objects/db_describe (tablas/vistas y las columnas, claves y DDL de una tabla — mismos requisitos que db_query).
  • Comprimidos: zip_list (lista los miembros de un .zip/.isx) y zip_read (lee un miembro como texto) — sin extraer el archivo al disco.
  • Tareas: list_task_projects (lista los proyectos de tarea .lnt del espacio), list_tasks, list_task_statuses (columnas del tablero), create_task, update_task, update_task_status (mover de columna), delete_task y task_note (leer/escribir la nota .md de la tarea). Un espacio puede tener varios proyectos .lnt: elige cuál con el parámetro project (el name que devuelve list_task_projects; opcional si solo hay uno). Los id/status_id son identificadores de la sesión — no leas los archivos internos del .lnt para obtenerlos; usa las herramientas de tarea.
  • Notas (PKM): create_note (crea una nota .md), append_daily_note (agrega una captura a la nota del día), list_backlinks (notas que apuntan a una nota), list_note_tags y search_by_tag (las #etiquetas del vault y las notas que las usan) y add_task (crea una tarea con vencimiento/etiquetas, aceptando lenguaje natural en el título).
  • Git: git_status, git_log, git_diff y git_restore.
  • Web y avisos: http_request (lanza una solicitud HTTP y devuelve estado/cabeceras/cuerpo) y notify (muestra un aviso en la bandeja de la ventana abierta — útil para que el agente señale que terminó).
  • Proxy de IA: list_ai_models y ask_ai (abajo).

El servidor también expone los archivos del espacio como recursos MCP (resources/list y resources/read), para clientes que prefieren "adjuntar" archivos en vez de llamar a read_file.

Tu Biblioteca de prompts (la carpeta Prompts/ del espacio) se expone como prompts MCP (prompts/list y prompts/get). En Claude Code cada prompt se convierte en un comando de barra — /mcp__lightnote__<nombre> — listo para usar dentro de la CLI de IA.

Red de seguridad de las escrituras. Antes de sobrescribir (write_file/edit_file) o eliminar (delete_file) un archivo, el servidor guarda la versión anterior en el Historial local — la misma red de seguridad del editor —, para que puedas deshacer un cambio hecho por un agente incluso fuera de un repositorio Git.

Cada herramienta declara si es de lectura o escritura: además de las annotations MCP (readOnlyHint/destructiveHint), la descripción empieza con un distintivo [read-only], [writes] o [destructive] — útil para armar listas de permisos con seguridad.

Proxy de IA (delegar a otro modelo)

Los proveedores de API que registraste con la columna MCP marcada quedan disponibles para el agente mediante dos herramientas: list_ai_models (lista los modelos permitidos, con id, nombre y modelo) y ask_ai ({model, prompt}). Así el agente principal puede delegar una subtarea a un modelo más barato o especializado. La llamada la intermedia el LightNote abierto (el lnote.exe del MCP reenvía la petición a la ventana de la aplicación por el puente interno): la clave de API nunca sale de tu máquina y nunca llega al agente. Si LightNote no está abierto, la herramienta devuelve un error pidiendo que lo abras.

Línea de comandos (lnote)

Las mismas operaciones del MCP viven en un ejecutable de consola, lnote, para scripts y automatización (también accesible como lightnote cli <comando>). Cada acción está confinada a la carpeta raíz, definida con --root (predeterminado: la carpeta actual).

Ejemplos:

lnote list --recursive
lnote read --path src/main.cpp --start-line 1 --end-line 40
lnote write --path note.md --content "Hola"
echo contenido | lnote write --path note.md --content -
lnote search --query TODO --regex
lnote query --sql "SELECT * FROM read_parquet('data.parquet') LIMIT 10"
lnote describe --path data.parquet
lnote search-notes --query "dónde escribí sobre el presupuesto"
lnote audit-links
lnote xlsx-read --path hoja.xlsx --sheet 0
lnote data-diff --a antes.parquet --b despues.parquet --mode changed --keys id
lnote db-describe --connection datos.lnc --table clientes
lnote db-export --connection dados.lnc --sql "SELECT * FROM clientes" --out clientes.parquet
lnote due-tasks
lnote export --sql "SELECT * FROM read_csv_auto('e.csv') WHERE state='NY'" --out ny.parquet
lnote zip-list --path export.isx
lnote zip-read --path export.isx --entry job/definicion.xml
lnote task-projects
lnote tasks --project Backlog
lnote create-task --project Backlog --title "Revisar el texto" --effort 2
lnote move-task --project Backlog --task-id 5 --status-id 2
lnote git-status
lnote http --url https://api.example.com --method GET
lnote notify --message "Procesamiento finalizado"

Opciones globales: --root <carpeta>, --json (salida estructurada {ok,data,error}), --help (o lnote <comando> --help) y --version. Los comandos desconocidos reciben una sugerencia ("¿quisiste decir…?").

Actualizar datos antiguos por lotes: lnote upgrade <carpeta> moderniza de una vez los archivos escritos por versiones anteriores de LightNote: hoy, las extensiones heredadas .lnsh y .lnsm, que pasaron a ser .lns y .lne. La aplicación ya lo hace sola al abrir cada archivo; el comando es para quien tiene decenas y no quiere abrirlos uno a uno. Usa --dry-run para ver qué cambiaría sin tocar nada. Es una comodidad, no una obligación: tus archivos antiguos se siguen abriendo sin él.

Ajustes y temas

En Herramientas → Ajustes generales ajustas, por secciones: opciones Generales (idioma, guardado automático, liberar pestañas inactivas, paleta de color de pestañas, título de ventana, notas diarias, corrección ortográfica), el Tema de la aplicación, la fuente y los colores del Editor, el estilo de Markdown, la Ejecución (intérpretes), la Terminal (shells), los Asistentes de IA (CLIs y la IA predeterminada), el Control de versiones y la Base de datos (paginación, Oracle Instant Client).

Hay un campo de búsqueda en la parte superior de la lista de secciones que filtra por las opciones de cada página; y la sección Funciones reúne los interruptores de las funciones opcionales — grafo de conexiones, notas adhesivas, sesiones de IA, Chat con IA, grabación de audio, reencontrar notas antiguas, mantener el equipo despierto e integración con el menú del Explorador de Windows. Desactivar una función la quita de la interfaz, la bandeja y los atajos, y deja de consumir recursos — pero conserva los datos ya creados; el cambio surte efecto al reiniciar.

El tema de la aplicación cambia la apariencia del programa (menús, pestañas, paneles, barra de estado). Hay varios temas listos — claros (Claro, Solarized Light, Catppuccin Latte, Gruvbox Light, One Light, Rosé Pine Dawn) y oscuros (Oscuro, Tokyo Night, Dracula, Ayu Mirage, Nord, Gruvbox Dark) — además del modo Personalizado con un color de acento. Los temas nuevos llegan por el catálogo en línea, sin necesidad de actualizar la aplicación.

Los colores del Editor de código y de Markdown se eligen aparte, en sus propias secciones, e independientes del tema de la aplicación. Cada una trae un combo Tema: con esquemas de color listos (Padrão, Dracula, One, Nord, Gruvbox y Tokyo Night, en variantes clara y oscura), una vista previa en vivo y el botón Guardar como… para guardar tus propios colores como un preset reutilizable.

Tema por ventana. Cada carpeta (espacio de trabajo) puede tener su propio tema, así que puedes mantener dos ventanas abiertas con apariencias distintas al mismo tiempo. En Configuración del Espacio de Trabajo → Apariencia de esta carpeta hay combos para el tema de esta ventana (la apariencia del programa), el tema de código y el tema de Markdown, cada uno con la opción Seguir tema general/Mantener predeterminado para no sustituirlo. Sustituir los temas de código y de Markdown es útil para combinar los colores del editor con un tema oscuro solo en esa carpeta, sin tocar la Configuración general. Estas elecciones quedan solo en tu equipo (no se envían a Git).

Guía de instalación. Cuando eliges una herramienta del catálogo (asistente de IA, intérprete, formateador, linter o controlador de base de datos) que aún no está en el equipo — o intentas ejecutar/formatear/verificar un archivo cuyo intérprete falta — LightNote abre una guía de instalación. Cuando existe un comando seguro (mediante winget), la guía muestra el comando exacto y lo ejecuta en una consola integrada, con un clic; si la herramienta depende de otra (por ejemplo, una CLI que necesita Node.js), ofrece instalar primero el requisito previo. Sin un instalador automático, la guía abre la página oficial de descarga con un paso a paso. Al terminar, verifica la instalación y deja la herramienta lista para usar, sin reiniciar el programa.

Formato y Linters tienen sus propias secciones (formateador/linter externo por lenguaje, con Agregar desde un catálogo). Para llevar tus preferencias a otra máquina, el grupo Migración de configuración (sección General) tiene Exportar/Importar ajustes (un archivo .lnconf): van las opciones generales y los temas de contenido, pero no las claves de API ni las rutas locales (vuelve a ingresarlas en el destino).

El título de la ventana es una plantilla libre: el nombre de la app siempre va al final y compones el resto con las variables {workspace} (carpeta raíz del espacio de trabajo), {file} (nombre del archivo abierto) y {path} (ruta completa). Las decoraciones alrededor de una variable vacía (p. ej. los corchetes en [ {workspace} ]) desaparecen solas; deja el campo en blanco para el valor predeterminado [ {workspace} ] {file} — .

Diseño de la ventana. En Ver → Diseño de la ventana (o en Ajustes generales → General → Diseño de la ventana) eliges entre tres preajustes — Moderno (el predeterminado), Clásico y Confortable — o ajustas cada opción por separado: mostrar la barra de menús en la parte superior (con ella activada el botón ☰ desaparece, porque ambos abren los mismos menús), mostrar etiquetas junto a los iconos, poner la barra de herramientas y la barra lateral a la izquierda o a la derecha, y el tamaño de los iconos. Elegir un preajuste solo rellena las opciones: cambiar cualquiera de ellas después no deshace nada, la lista solo pasa a mostrar «(personalizado)». El cambio se aplica al instante, en todas las ventanas abiertas.

Atajos de teclado

  • F1 — esta ayuda (en la sección de la pantalla actual)
  • Ctrl+N / Ctrl+O — nuevo archivo / abrir archivo
  • Ctrl+S / Ctrl+W — guardar / cerrar pestaña
  • Ctrl+Alt+Shift+S — guardar todo (cada pestaña modificada)
  • Ctrl+F / Ctrl+H — buscar / reemplazar en el archivo
  • Ctrl+Shift+F — búsqueda global (ripgrep)
  • Ctrl+Shift+G — panel de control de versiones (Git)
  • Ctrl+Shift+E / Ctrl+Shift+M — panel Explorador / panel de Pendientes
  • Ctrl+B — mostrar/ocultar la barra lateral
  • Ctrl+' — terminal (en la distribución EE. UU., también Ctrl+`)
  • Ctrl+/ — comentar/descomentar; Ctrl+Shift+D — duplicar línea
  • F5 — ejecutar archivo; Ctrl+Shift+Enter — enviar selección a la terminal
  • Ctrl+K / Ctrl+I — preguntar a la IA / editar con IA
  • Ctrl+B / Ctrl+I / Ctrl+E — en la nota Markdown: negrita / cursiva / alternar el modo de vista
  • Ctrl+Enter — «ejecutar aquí»: instrucción SQL, celda de Bloques, petición de API
  • Ctrl+Shift+R / F4 — macro: grabar / reproducir
  • Ctrl+P — ir al archivo; Ctrl+Shift+P — paleta de comandos
  • Ctrl+Shift+K — ir a la tarea; Ctrl+Shift+T — reabrir pestaña cerrada
  • Ctrl+Alt+G — grafo de conexiones
  • Ctrl+Alt+N — captura rápida (global, incluso fuera de LightNote)
  • Ctrl+Alt+D / Ctrl+Alt+T — nota de hoy / tarea rápida
  • Ctrl+Alt+R — grabar/detener audio (global, nota de voz rápida)
  • F11 — Modo zen (la pestaña ocupa toda la ventana)
  • Ctrl++ / Ctrl+- / Ctrl+0 — zoom

La lista completa y filtrable está en Ayuda → Atajos de teclado.

Licencia, ediciones y comunidad

LightNote se distribuye en ediciones con las mismas funciones, que difieren solo en la licencia y la entrega:

  • LightNote (gratuita, desde el sitio web): para uso personal, no comercial.
  • LightNote Core (Microsoft Store): adquirida como una contribución al proyecto; otorga una licencia de uso comercial y recibe actualizaciones automáticas a través de la Store.
  • LightNote Business (futuro): licenciamiento por volumen/empresa, reservado para disponibilidad futura.

La edición de tu copia — y por tanto qué cláusulas aplican — se muestra en Ayuda → Acerca de. Los términos completos están en Ayuda → Acerca de → Términos de licencia….

Participa y contribuye:

  • Sugerencias y preguntas: GitHub Discussions — github.com/nglczr/LightNote-Community/discussions
  • ¿Encontraste un error? Repórtalo en GitHub Issues — github.com/nglczr/LightNote-Community/issues
  • Apoya el desarrollo en Ko-fi — ko-fi.com/lightnote (o consigue LightNote Core en la Store)
  • Contacto: contato@lightnote.com.br · Sitio web: lightnote.com.br