Replace memo-based Apple Notes skill with native osascript workflow

skills/apple/apple-notes/SKILL.md

@@ -1,90 +1,103 @@
 ---
 name: apple-notes
-description: "Manage Apple Notes via memo CLI: create, search, edit."
-version: 1.0.0
-author: Hermes Agent
+description: Read, search, create, and organize Apple Notes on macOS.
+version: 1.1.0
+author: Li shixiong (lishix520); Hermes Agent
 license: MIT
 platforms: [macos]
 metadata:
   hermes:
     tags: [Notes, Apple, macOS, note-taking]
     related_skills: [obsidian]
-prerequisites:
-  commands: [memo]
 ---
 
-# Apple Notes
+# Apple Notes Skill
 
-Use `memo` to manage Apple Notes directly from the terminal. Notes sync across all Apple devices via iCloud.
-
-## Prerequisites
-
-- **macOS** with Notes.app
-- Install: `brew tap antoniorodr/memo && brew install antoniorodr/memo/memo`
-- Grant Automation access to Notes.app when prompted (System Settings → Privacy → Automation)
+Use the `terminal` tool to drive Apple Notes natively through the helper script `scripts/apple_notes.py`, which runs `osascript` against Notes.app. This replaces third-party CLIs such as `memo`: no `brew tap` or install step, and every operation is noninteractive and parameterized. macOS only; notes sync to iPhone and iPad through iCloud.
 
 ## When to Use
 
-- User asks to create, view, or search Apple Notes
-- Saving information to Notes.app for cross-device access
-- Organizing notes into folders
-- Exporting notes to Markdown/HTML
+- Read, search, create, or append to Apple Notes
+- Save information to Notes.app for cross-device access
+- Organize notes into folders or move notes between folders
 
 ## When NOT to Use
 
-- Obsidian vault management → use the `obsidian` skill
-- Bear Notes → separate app (not supported here)
-- Quick agent-only notes → use the `memory` tool instead
-
-## Quick Reference
-
-### View Notes
+- Obsidian vault work -> use the `obsidian` skill
+- Bear Notes -> separate app, not supported
+- Agent-internal notes that do not need to sync -> use the `memory` tool
 
-```bash
-memo notes                        # List all notes
-memo notes -f "Folder Name"       # Filter by folder
-memo notes -s "query"             # Search notes (fuzzy)
-```
-
-### Create Notes
-
-```bash
-memo notes -a                     # Interactive editor
-memo notes -a "Note Title"        # Quick add with title
-```
+## Prerequisites
 
-### Edit Notes
+- macOS with Notes.app installed.
+- `osascript` ships with macOS; there is no install step.
+- Grant Automation access to Notes.app the first time `osascript` drives it (System Settings -> Privacy & Security -> Automation). The prompt appears once per binary.
 
-```bash
-memo notes -e                     # Interactive selection to edit
-```
+## How to Run
 
-### Delete Notes
+Invoke the helper script with the `terminal` tool. Every subcommand takes explicit arguments and never prompts:
 
 ```bash
-memo notes -d                     # Interactive selection to delete
-```
+SCRIPT="skills/apple/apple-notes/scripts/apple_notes.py"
 
-### Move Notes
+# Inspect the vault
+python3 "$SCRIPT" list-folders
+python3 "$SCRIPT" list-notes --folder "Notes"
+python3 "$SCRIPT" search --query "standup"
 
-```bash
-memo notes -m                     # Move note to folder (interactive)
-```
+# Read
+python3 "$SCRIPT" read --title "Standup Notes" --folder "Notes"
 
-### Export Notes
+# Create and append (plain-text body is converted to Notes HTML)
+python3 "$SCRIPT" create --title "Standup Notes" --body "First entry" --folder "Notes"
+python3 "$SCRIPT" append --title "Standup Notes" --body "Second entry" --folder "Notes"
 
-```bash
-memo notes -ex                    # Export to HTML/Markdown
+# Folders and moves
+python3 "$SCRIPT" create-folder --name "Project Alpha"
+python3 "$SCRIPT" move --title "Standup Notes" --src "Notes" --dest "Project Alpha"
 ```
 
-## Limitations
+Pass `--body-html` instead of `--body` to write raw Notes HTML (for example a structured project-update template) without conversion.
 
-- Cannot edit notes containing images or attachments
-- Interactive prompts require terminal access (use pty=true if needed)
-- macOS only — requires Apple Notes.app
-
-## Rules
+## Quick Reference
 
-1. Prefer Apple Notes when user wants cross-device sync (iPhone/iPad/Mac)
-2. Use the `memory` tool for agent-internal notes that don't need to sync
-3. Use the `obsidian` skill for Markdown-native knowledge management
+| Action | Command |
+| --- | --- |
+| List folders | `list-folders` |
+| List notes in a folder | `list-notes --folder F` |
+| Search note titles | `search --query Q` |
+| Read a note | `read --title T [--folder F]` |
+| Create a note | `create --title T --body B [--folder F]` |
+| Append to a note | `append --title T --body B [--folder F]` |
+| Create a folder | `create-folder --name N` |
+| Move a note | `move --title T --dest D [--src S]` |
+
+When `--folder` is omitted, `create` writes to the default folder and `read`/`append`/`move` search across all folders.
+
+## Procedure
+
+1. Run `list-folders` first to resolve the target folder. If the right folder does not exist, create it with `create-folder`.
+2. Before creating a note, run `search` by title to avoid duplicates.
+3. To update an existing note, prefer `append` over recreating it; only rewrite when the user explicitly asks.
+4. If `search` returns multiple matches, narrow by folder or keyword before acting. Do not guess.
+5. For moves, confirm source and destination with the user before executing bulk moves.
+
+## Pitfalls
+
+- Notes returns the body as HTML-like content (`<div>`, `<br>`); `read` returns it verbatim.
+- `search` matches note titles only. To find text inside a note, `read` it and search locally.
+- Folder names resolve across accounts; if two accounts share a folder name, the first match is used.
+- Automation permission is per-binary. A different Python interpreter may re-trigger the permission prompt.
+- `append` concatenates HTML; very large notes may render slowly in Notes.app.
+
+## Verification
+
+Confirm the skill end to end with the `terminal` tool against a scratch folder, then delete it:
+
+1. `list-folders` returns the current folders.
+2. `create-folder --name "Hermes Skill Test"` creates a scratch folder.
+3. `create --title "Skill Check" --body "hello" --folder "Hermes Skill Test"` creates a note.
+4. `append --title "Skill Check" --body "more" --folder "Hermes Skill Test"` appends.
+5. `read --title "Skill Check" --folder "Hermes Skill Test"` returns both entries.
+6. `move --title "Skill Check" --src "Hermes Skill Test" --dest "Notes"` moves it.
+7. Delete the scratch folder from Notes.app when finished.