Назад към всички

notesctl

// Manage Apple Notes via deterministic local scripts (create, append, list, search, export, and edit). Use when a user asks OpenClaw to add a note, list notes, search notes, or manage note folders.

$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namenotesctl
descriptionManage Apple Notes via deterministic local scripts (create, append, list, search, export, and edit). Use when a user asks OpenClaw to add a note, list notes, search notes, or manage note folders.
metadata[object Object]

notesctl (Apple Notes, low-token)

Goal

Minimize token usage and avoid fragile quoting by routing Apple Notes operations through bundled scripts.

Quick start

Create a new note (deterministic title/body)

  • JSON stdin (recommended):
echo '{"title":"Title","body":"Line 1\nLine 2","folder":"Notes"}' | {baseDir}/scripts/notes_post.sh
  • Direct args:
{baseDir}/scripts/notes_new.sh "Title" $'Body line 1\nBody line 2' "Notes"

List/search/export

{baseDir}/scripts/notes_list.sh "Notes"
{baseDir}/scripts/notes_search.sh "query" "Notes"
{baseDir}/scripts/notes_export.sh "query" "Notes" "/tmp"  # interactive select then export

Output conventions

  • Keep receipts short: Wrote to Notes: <title>.

Notes on editing

Editing existing notes is inherently more fragile:

  • Prefer append workflows or create a new note with a reference.
  • If the user explicitly wants interactive editing, use memo notes -e (manual selection + editor).