# Send Apple Notes (AppleScript) to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "apple-notes-applescript",
    "name": "Apple Notes (AppleScript)",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/shad0wca7/apple-notes-applescript",
    "canonicalUrl": "https://clawhub.ai/shad0wca7/apple-notes-applescript",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/apple-notes-applescript",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=apple-notes-applescript",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/_resolve_folder.sh",
      "scripts/notes-attachment.sh",
      "scripts/notes-create.sh",
      "scripts/notes-delete.sh",
      "scripts/notes-edit.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "apple-notes-applescript",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T03:17:17.385Z",
      "expiresAt": "2026-05-07T03:17:17.385Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=apple-notes-applescript",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=apple-notes-applescript",
        "contentDisposition": "attachment; filename=\"apple-notes-applescript-1.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "apple-notes-applescript"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/apple-notes-applescript"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/apple-notes-applescript",
    "downloadUrl": "https://openagent3.xyz/downloads/apple-notes-applescript",
    "agentUrl": "https://openagent3.xyz/skills/apple-notes-applescript/agent",
    "manifestUrl": "https://openagent3.xyz/skills/apple-notes-applescript/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/apple-notes-applescript/agent.md"
  }
}
```
## Documentation

### Apple Notes

Interact with Notes.app via AppleScript. Run scripts from: cd {baseDir}

### Commands

CommandUsageList foldersscripts/notes-folders.sh [--tree] [--counts]List notesscripts/notes-list.sh [folder] [limit]Read notescripts/notes-read.sh <name-or-id> [folder]Create notescripts/notes-create.sh <folder> <title> [body]Search notesscripts/notes-search.sh <query> [folder] [limit] [--title-only]Edit notescripts/notes-edit.sh <name-or-id> <new-body> [folder]Delete notescripts/notes-delete.sh <name> <folder> ⚠️ folder required

### Folder Paths

All commands support subfolder paths with / separator:

scripts/notes-list.sh "Scanned/Medical & Health" 10
scripts/notes-read.sh "blood test" "Scanned/Medical & Health"
scripts/notes-create.sh "Property/416 Garfield" "Inspection notes" "Roof looks good"

### Folder Tree Structure

This collection has 4000+ notes. Key structure:

Scanned — parent folder with many subfolders (Medical & Health, Receipts, etc.)
Fetish — parent with subfolders (AW, Bimbo, Events, etc.)
Hobbies — parent with subfolders (3d printing, Homelab, etc.)
Property — subfolders per address

Use --tree --counts to see the full hierarchy.

### Folder Listing

scripts/notes-folders.sh                  # Flat list
scripts/notes-folders.sh --counts         # With note counts
scripts/notes-folders.sh --tree --counts  # Full hierarchy with counts

### Listing Notes

scripts/notes-list.sh "Notes" 10                      # Specific folder
scripts/notes-list.sh "Scanned/Receipts" 5             # Subfolder
scripts/notes-list.sh "" 10                             # All folders (shows folder name per note)

Without a folder, output includes the folder column: ID | Date | Folder | Title
With a folder: ID | Date | Title

### Reading Notes

scripts/notes-read.sh "blood test" "Scanned/Medical & Health"   # By name (partial match)
scripts/notes-read.sh "x-coredata://…/ICNote/p12345"            # By ID (direct lookup, fast)

Output: Title, Folder, Modified date, ID, then body text.

### Searching

Title search first (fast), body search fallback (slower):

scripts/notes-search.sh "tax" "" 10                    # All folders
scripts/notes-search.sh "receipt" "Scanned/Receipts" 5  # Specific folder
scripts/notes-search.sh "keyword" "" 10 --title-only    # Skip body search

Output: ID | Date | Folder | Title

### Creating Notes

scripts/notes-create.sh "Notes" "My Title" "Body text here"   # With body
scripts/notes-create.sh "Notes" "Empty Note"                    # Title only

Returns the created note's ID.

### Editing Notes

scripts/notes-edit.sh "My Note" "New body content" "Notes"              # By name
scripts/notes-edit.sh "x-coredata://…/ICNote/p12345" "New body"         # By ID

### Deleting Notes

scripts/notes-delete.sh "Old Note" "Notes"                    # Folder required
scripts/notes-delete.sh "receipt" "Scanned/Receipts"

⚠️ Folder argument is required for safety — prevents accidental matches across 4000+ notes.

### Performance Tips

SituationTipListing/searching all notesAlways specify a folder — iterating 4000+ notes is slowReading a known noteUse the ID from a previous list/search — instant lookupSearching large foldersUse --title-only if body search isn't neededFinding the right folderUse --tree --counts first to see hierarchy

### Errors

ErrorCauseError: Can't get folderFolder name doesn't exist or wrong pathNo note matching…No partial match found in scopeEmpty body textScanned/image-only notes have no extractable text

### Technical Notes

Partial name matching for read/edit/delete (first match wins)
Multiline body supported via temp files
Folder names are case-sensitive
All user inputs escaped for AppleScript safety (quotes, backslashes)
number of used instead of count of (AppleScript reserved word)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: shad0wca7
- Version: 1.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T03:17:17.385Z
- Expires at: 2026-05-07T03:17:17.385Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/apple-notes-applescript)
- [Send to Agent page](https://openagent3.xyz/skills/apple-notes-applescript/agent)
- [JSON manifest](https://openagent3.xyz/skills/apple-notes-applescript/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/apple-notes-applescript/agent.md)
- [Download page](https://openagent3.xyz/downloads/apple-notes-applescript)