# Send Manage Apple Notes 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "managing-apple-notes",
    "name": "Manage Apple Notes",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/wangwalk/managing-apple-notes",
    "canonicalUrl": "https://clawhub.ai/wangwalk/managing-apple-notes",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/managing-apple-notes",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=managing-apple-notes",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "managing-apple-notes",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T07:32:56.858Z",
      "expiresAt": "2026-05-12T07:32:56.858Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=managing-apple-notes",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=managing-apple-notes",
        "contentDisposition": "attachment; filename=\"managing-apple-notes-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "managing-apple-notes"
      },
      "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/managing-apple-notes"
    },
    "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/managing-apple-notes",
    "downloadUrl": "https://openagent3.xyz/downloads/managing-apple-notes",
    "agentUrl": "https://openagent3.xyz/skills/managing-apple-notes/agent",
    "manifestUrl": "https://openagent3.xyz/skills/managing-apple-notes/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/managing-apple-notes/agent.md"
  }
}
```
## Documentation

### Managing Apple Notes with inotes

inotes is a macOS CLI for Apple Notes. It communicates with Notes.app via AppleScript and supports all CRUD operations plus search. Output defaults to a human-readable table; use --json for machine-readable output.

### 🔒 Privacy & Security

✅ Open source: Full source code at https://github.com/wangwalk/inotes
✅ Local-only: All operations run locally via AppleScript; no data leaves your machine
✅ No network calls: inotes does not connect to any remote servers
✅ Auditable install: Binary installed via Homebrew from signed release or GitHub Releases
✅ MIT Licensed: Free and open for inspection and contributions
⚠️ Requires macOS Automation permission for Notes.app (user grants via System Settings)
📦 Universal binary: Supports both Apple Silicon (arm64) and Intel (x86_64)

### Prerequisites

System Requirements:

macOS 14+ (Sonoma or later)
Apple Notes.app (comes with macOS)

Install via Homebrew (recommended):

brew install wangwalk/tap/inotes

Verify installation:

inotes --version  # Should show: 0.1.2
which inotes      # Should be in /opt/homebrew/bin/ or /usr/local/bin/

Manual installation from GitHub Releases:

Download from GitHub Releases and verify SHA256:

curl -LO https://github.com/wangwalk/inotes/releases/download/v0.1.2/inotes-0.1.2-universal-apple-darwin.tar.gz
# Verify checksum from release notes
tar xzf inotes-0.1.2-universal-apple-darwin.tar.gz
sudo cp inotes /usr/local/bin/
sudo chmod +x /usr/local/bin/inotes

Check permission:

inotes status

If permission is denied, the user must enable Automation access for their terminal in System Settings > Privacy & Security > Automation > Notes.

### List notes

inotes                            # recent iCloud notes (default)
inotes today                      # modified today
inotes show week                  # modified this week
inotes show all                   # all notes
inotes show --folder Work         # notes in a specific folder
inotes show recent --limit 10    # limit results

### List folders

inotes folders

### List accounts

inotes accounts

### Create a folder

inotes mkfolder "Projects"
inotes mkfolder "Work Notes" --account Exchange

### Read a note

inotes read 1        # by index from last show output
inotes read A3F2     # by ID prefix (4+ characters)

### Create a note

inotes add --title "Meeting Notes" --body "Action items" --folder Work

### Edit a note

inotes edit 1 --title "Updated Title"
inotes edit 2 --body "New content" --folder Projects

### Delete a note

inotes delete 1              # with confirmation
inotes delete 1 --force      # skip confirmation

### Search notes

inotes search "quarterly review"
inotes search "TODO" --folder Work --limit 10

### Multi-account support

By default only iCloud notes are shown. Use --account <name> or --all-accounts to access other accounts.

inotes accounts                    # list available accounts
inotes show all --account Exchange
inotes show all --all-accounts

### Output formats

FlagDescription(default)Human-readable table--json / -jJSON--plainTab-separated--quiet / -qCount only

### Agent usage guidelines

Always use --json when you need to parse output programmatically.
Use --no-input to disable interactive prompts in non-interactive contexts.
Use --no-color when capturing output to avoid ANSI escape sequences.
Identify notes by index (from the last show output) or by ID prefix (first 4+ hex characters of the note ID).
Run inotes status first to verify automation permission before attempting other commands.
The CLI automatically filters out notes in "Recently Deleted" folders across all supported languages.

### Examples for common tasks

Create daily note:

inotes add --title "Daily Notes $(date +%Y-%m-%d)" --body "## TODO\\n\\n## Done\\n"

Export all notes to JSON:

inotes show all --json > notes-backup.json

Find notes with specific tag:

inotes search "#important" --json | jq '.[] | select(.folder == "Work")'

Archive completed notes:

inotes search "DONE" --folder Inbox --json | jq -r '.[].id' | while read id; do
  inotes edit "$id" --folder Archive
done

### Troubleshooting

"Automation permission denied"

Go to System Settings > Privacy & Security > Automation
Find your terminal app (e.g., Terminal.app, iTerm.app)
Enable access to "Notes"

"Command not found"

Run which inotes to check if it's in your PATH
If using Homebrew: brew doctor and check for warnings
Try brew reinstall wangwalk/tap/inotes

"Note not found" when using index

Run inotes show again to get fresh indices
Use ID prefix instead: inotes read A3F2

Performance issues with many notes

Use --limit flag to reduce result set
Filter by folder: --folder "Work"
Use date filters: today, week, recent

### Additional resources

GitHub: https://github.com/wangwalk/inotes
Releases: https://github.com/wangwalk/inotes/releases
Issues: https://github.com/wangwalk/inotes/issues
License: MIT
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: wangwalk
- Version: 1.0.1
## 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-05-05T07:32:56.858Z
- Expires at: 2026-05-12T07:32:56.858Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/managing-apple-notes)
- [Send to Agent page](https://openagent3.xyz/skills/managing-apple-notes/agent)
- [JSON manifest](https://openagent3.xyz/skills/managing-apple-notes/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/managing-apple-notes/agent.md)
- [Download page](https://openagent3.xyz/downloads/managing-apple-notes)