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