nanotes

name	nanotes
description	Read and create notes with the nanotes CLI. Use when working on a Mac where nanotes is installed and you need Apple Notes data from the terminal.

nanotes CLI

Use nanotes directly. Always pass --json for structured output.

Read

nanotes folders --json
nanotes list --limit 20 --json
nanotes list --folder "Work" --limit 20 --json
nanotes recent --json                              # last 3 days
nanotes recent --since 1w --json                   # last week
nanotes recent --content --json                    # with note bodies
nanotes today --json
nanotes today --content --json                     # with note bodies
nanotes search "query" --limit 20 --json
nanotes show --id "x-coredata://..." --json
nanotes show --id "x-coredata://..." --json --html
nanotes attachments --id "x-coredata://..." --json
nanotes dump --id "x-coredata://..."

Write

nanotes create --title "Title" --folder "Work" --body "Body text" --json

Workflow

1. Run folders first when folder names are unknown.
2. Get note IDs from list or search.
3. Use show --json --html when formatting or attachment tags matter.
4. Ask for confirmation before creating a note.

nanotes currently supports create-only writes. Editing, appending, deleting, and attaching files to existing notes are not implemented.