Tus notas,
headless.

Añade texto a la nota diaria de hoy (título DD-MM-YYYY) — o a cualquier nota con --title. Crea la nota si no existe; el texto se añade al final de la sección, separado por un salto de línea.

--title <title>

Escribe en la nota con ese título en vez de la del día.

--section <name>

Sección/pestaña destino. La crea si no existe. Default: Note.

--tag <tag>

Añade este tag a la nota (si no lo tiene ya).

--group <name>

Asigna la nota a un grupo.

--folder <name>

Coloca la nota en una carpeta de ese grupo (requiere --group).

--raw / --rich

Sección nueva en modo raw/markdown (default) o rich text.

$ noteflow add "Fix: CORS on /api/notes"$ noteflow add "Check server logs" --section Tasks --tag urgent

Crea una nota vacía.

--section <name>

Nombre de la primera sección. Default: Note.

--group <name>

Asignar a un grupo.

--folder <name>

Colocar en una carpeta de ese grupo (requiere --group).

--json

Devuelve { id, title, dirname } en JSON.

$ noteflow new "Sprint 14" --group backend --section Planning

Lista las notas ordenadas por updated desc. Excluye archivadas por defecto.

--tag <tag>

Filtrar por tag.

--group <name>

Filtrar por grupo.

--folder <name>

Filtrar por carpeta (desambigua con --group si el nombre se repite).

--archived

Incluir notas archivadas.

--json

Array JSON con la metadata completa de cada nota (id, title, tags, group, folder, fechas, sections…).

$ noteflow list --tag urgent --json

Muestra una nota formateada para humanos (indentada, decorada). El título puede ser parcial — con varios matches muestra la lista y pide más precisión. Para pipes o agentes, usa read.

--section <name>

Mostrar solo esa sección.

--json

JSON completo con todas las secciones y su contenido.

Imprime el contenido tal cual en stdout — sin indentar ni decorar. La forma recomendada de leer una sección para pipes y agentes. Nombres de sección duplicados se direccionan con sufijo 1-based, p. ej. "Tasks#2".

--section <name>

Forma con flag de la sección posicional (útil con títulos multi-palabra).

--json

JSON con todas las secciones (o solo una si se indica).

$ noteflow read "Project Alpha" Tasks$ noteflow read "Project Alpha" --json | jq '.sections[].name'

Reemplaza el contenido de una sección (la crea si no existe) — el complemento de add, que solo añade al final. La forma recomendada de editar una sección. Ante nombres duplicados ambiguos sin sufijo #n, falla en vez de adivinar.

--text "<content>"

Texto inline (gana la primera fuente presente).

--file <path>

Lee el contenido de un archivo — la vía más fiable en Windows/PowerShell.

--stdin

Lee de stdin (también se usa automáticamente al recibir un pipe).

--rich

Si crea la sección, la crea en modo rich text (default: raw).

$ noteflow set "Project Alpha" Tasks --text "- [ ] deploy"$ cat todo.md | noteflow set "Project Alpha" Tasks --stdin

Elimina una nota (alias: rm). Pide confirmación salvo con --yes. Con sync activo también la elimina del repositorio de GitHub.

Actualiza el campo title de la nota. El nombre de la carpeta en disco no cambia (contiene el id).

Alterna el campo favorited (alias: pin). La app de escritorio muestra las favoritas arriba de la lista.

Alterna el estado archived. Las archivadas no aparecen en list salvo con --archived.

Lista las secciones de una nota con nombre, número de líneas y modo (raw/rich). section list es un alias.

Crea una sección vacía (raw por defecto; --rich para rich text). Las secciones se gestionan por nombre — sin ids.

$ noteflow section add "Project Alpha" "Meeting Notes"

Renombra una sección (el archivo en disco no cambia — va por id).

Borra una sección (confirmación salvo --yes). Rechaza borrar la última. Desambigua duplicados con "Tasks#2".

Mueve una nota entre grupos y carpetas — el equivalente CLI del drag-and-drop de la app. --group a secas la lleva a la raíz del grupo (limpia la carpeta); --ungroup la saca de ambos.

$ noteflow move "Sprint 14" --group backend --folder Planning$ noteflow move "Sprint 14" --ungroup

Lista los grupos.

Crea un grupo. Colores: accent (default), accent-2, red, cyan, purple, text, orange, pink.

$ noteflow group create backend --color cyan

Elimina un grupo. Sus notas quedan sin grupo (no se borran). Sus carpetas también se borran — las carpetas solo existen dentro de un grupo.

Lista las carpetas — todas agrupadas por grupo, o solo las de uno con --group.

Crea una carpeta. --group es obligatorio — una carpeta no existe fuera de un grupo.

$ noteflow folder create Planning --group backend

Renombra una carpeta. Usa --group para desambiguar si el nombre se repite entre grupos.

Elimina una carpeta. Sus notas caen a la raíz del grupo (conservan el grupo, pierden la carpeta) — no se borra ninguna.

Conecta con GitHub vía Device Flow OAuth — muestra un código y una URL para autorizar desde cualquier navegador (ideal en headless). Repo por defecto: noteflow-notes. El CLI guarda su propio token, separado del de la app de escritorio.

Desconecta de GitHub.

Sube todas las notas al repositorio.

Baja las notas del repo (alias: update). Solo sobreescribe una nota local cuando el updated remoto es más reciente.

Migración única del layout plano v1 (<slug>-<id>.md) al formato v2 carpeta-por-nota. Escribe el marcador .noteflow-format y, con token de sync accesible, sube el nuevo layout y borra los archivos planos del remoto. Idempotente — la app de escritorio ejecuta la misma migración local al arrancar.

Descarga el último cli/noteflow.js de GitHub y reemplaza el script actual. Usa la API pública del repo — no requiere login de sync. Útil en una RPi headless sin instalador.

Muestra número de notas, directorio, grupos, estado de GitHub y última sync. JSON: { notesDir, noteCount, github: { owner, repo, lastSync, tokenAccessible }, groups }.

Ayuda general, o detallada de un comando (help new, help folder…).