Your notes,
headless.

Append text to today’s daily note (title DD-MM-YYYY) — or to any note via --title. Creates the note if it doesn’t exist; the text is appended to the end of the section, separated by a newline.

--title <title>

Write into the note with that title instead of today’s.

--section <name>

Target section/tab. Created if missing. Default: Note.

--tag <tag>

Add this tag to the note (if it doesn’t have it yet).

--group <name>

Assign the note to a group.

--folder <name>

Place the note in a folder of that group (requires --group).

--raw / --rich

New section in raw/markdown mode (default) or rich text.

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

Create an empty note.

--section <name>

Name of the first section. Default: Note.

--group <name>

Assign to a group.

--folder <name>

Place in a folder of that group (requires --group).

--json

Print { id, title, dirname } as JSON.

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

List notes sorted by updated desc. Archived notes are excluded by default.

--tag <tag>

Filter by tag.

--group <name>

Filter by group.

--folder <name>

Filter by folder (disambiguate with --group if the name repeats).

--archived

Include archived notes.

--json

JSON array with full metadata per note (id, title, tags, group, folder, dates, sections…).

$ noteflow list --tag urgent --json

Pretty-print a note for humans (indented, decorated). The title can be partial — on multiple matches it lists them and asks for more precision. For piping or agents, use read instead.

--section <name>

Show only that section.

--json

Full JSON with every section and its content.

Print content verbatim to stdout — no indentation, no decoration. The recommended way to read a section for pipes and agents. Duplicate section names are addressed with a 1-based suffix, e.g. "Tasks#2".

--section <name>

Flag form of the positional section (handy with multi-word titles).

--json

JSON with every section (or just one if targeted).

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

Replace a section’s content (creating it if missing) — the complement of add, which only appends. The recommended way to edit a section. On ambiguous duplicate names without a #n suffix, it fails instead of guessing.

--text "<content>"

Inline text (first source present wins).

--file <path>

Read the content from a file — the most reliable route on Windows/PowerShell.

--stdin

Read from stdin (also used automatically when piped).

--rich

If the section is created, create it in rich-text mode (default: raw).

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

Delete a note (alias: rm). Asks for confirmation unless --yes. With sync active it also removes it from the GitHub repo.

Update the note’s title field. The folder name on disk doesn’t change (it contains the id).

Toggle the favorited flag (alias: pin). The desktop app shows favorites at the top of the list.

Toggle the archived state. Archived notes don’t show in list unless --archived.

List a note’s sections with name, line count and mode (raw/rich). section list is an alias.

Create an empty section (raw by default; --rich for rich text). Sections are managed by name — no ids needed.

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

Rename a section (the file on disk doesn’t change — it’s addressed by id).

Delete a section (confirmation unless --yes). Refuses to delete the last one. Disambiguate duplicates with "Tasks#2".

Move a note between groups and folders — the CLI equivalent of the app’s drag-and-drop. --group alone moves it to the group root (clearing the folder); --ungroup takes it out of both.

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

List groups.

Create a group. Colors: accent (default), accent-2, red, cyan, purple, text, orange, pink.

$ noteflow group create backend --color cyan

Delete a group. Its notes are left ungrouped (not deleted). Its folders are deleted too — folders only exist inside a group.

List folders — all of them grouped by group, or only one group’s with --group.

Create a folder. --group is required — a folder can’t exist outside a group.

$ noteflow folder create Planning --group backend

Rename a folder. Use --group to disambiguate if the name repeats across groups.

Delete a folder. Its notes fall to the group root (they keep the group, lose the folder) — nothing is deleted.

Connect to GitHub via Device Flow OAuth — it prints a code and a URL to authorize from any browser (perfect for headless boxes). Default repo: noteflow-notes. The CLI keeps its own token, separate from the desktop app’s.

Disconnect from GitHub.

Upload every note to the repo.

Download notes from the repo (alias: update). Only overwrites a local note when the remote updated timestamp is newer.

One-time migration from the flat v1 layout (<slug>-<id>.md) to the v2 folder-per-note format. Writes the .noteflow-format marker and, with an accessible sync token, pushes the new layout and removes the flat files from the remote. Idempotent — the desktop app runs the same local migration on startup.

Download the latest cli/noteflow.js from GitHub and replace the current script. Uses the public repo API — no sync login needed. Handy on a headless RPi with no installer.

Show note count, notes directory, groups, GitHub state and last sync. JSON shape: { notesDir, noteCount, github: { owner, repo, lastSync, tokenAccessible }, groups }.

General help, or detailed help for one command (help new, help folder…).