Command line (lnote)

Read the guideThe lnote command line Guide

The same MCP operations live in a console executable, lnote, for scripts and automation (also reachable as lightnote cli <command>). Every action is confined to the root folder, set by --root (default: the current folder).

Examples:

lnote list --recursive
lnote read --path src/main.cpp --start-line 1 --end-line 40
lnote write --path note.md --content "Hello"
echo content | 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 "where did I write about the budget"
lnote audit-links
lnote xlsx-read --path spreadsheet.xlsx --sheet 0
lnote data-diff --a before.parquet --b after.parquet --mode changed --keys id
lnote db-describe --connection data.lnc --table customers
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/definition.xml
lnote task-projects
lnote tasks --project Backlog
lnote create-task --project Backlog --title "Review the text" --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 "Processing finished"

Global options: --root <folder>, --json (structured {ok,data,error} output), --help (or lnote <command> --help) and --version. Unknown commands get a suggestion ("did you mean…?").

Bulk-update older data: lnote upgrade <folder> modernizes files written by earlier LightNote versions in one pass — currently the legacy .lnsh and .lnsm extensions, which became .lns and .lne. The app already does this on its own when you open each file; the command is for when you have dozens and don't want to open them one by one. Use --dry-run to preview what would change without touching anything. It is a convenience, not a requirement: your older files keep opening fine without it.