notectl - Apple Notes CLI

Manage Apple Notes from the command line using AppleScript.

Commands

Command	Description
notectl folders	List all folders with note counts
notectl list [folder]	List notes in a folder (default: Notes)
notectl show <title>	Show note content by title
notectl add <title>	Create a new note
notectl search <query>	Search notes by title or content
notectl append <title>	Append text to an existing note

Examples

# List all folders
notectl folders

# List notes in default folder
notectl list

# List notes in specific folder
notectl list "rainbat-projects"
notectl list Papi

# Show a note
notectl show "Meeting Notes"

# Create a note
notectl add "New Idea"
notectl add "Project Plan" --folder research --body "Initial thoughts..."

# Search all notes
notectl search "clawdbot"
notectl search "API"

# Append to a note (daily log style)
notectl append "Daily Log" --text "- Completed feature X"

Options for add

Option	Description	Default
-f, --folder <name>	Folder to create note in	Notes
-b, --body <text>	Note body content	empty

Options for append

Option	Description
-t, --text <text>	Text to append to the note

Available Folders

Folders on this system:

• Notes (default)
• research
• rainbat-projects
• Papi
• renova-roll
• Journal
• CheatSheets
• pet-projects