Apple Notes (Read Only)

Read notes via Notes.app AppleScript, and list their attachments by reading the Notes database. No creating, updating, or deleting notes.

Prerequisites

• Notes.app running and synced
• Automation permissions granted (System Settings → Privacy & Security → Automation → Terminal/Claude Code → Notes)
• If first access attempt times out, ask user to check for macOS permission dialog
• list-attachments.sh does not use AppleScript — it reads the Notes database directly, so it needs Full Disk Access for the terminal instead of Automation. It keeps working when the AppleScript bridge is wedged.

Reliability: always wrap osascript with timeout + retry

Notes.app's AppleScript bridge hangs intermittently. AppleScript-internal with timeout of N seconds does NOT kill a wedged osascript process — wrap with shell-level timeout and retry.