{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/managing-apple-notes",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=managing-apple-notes",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/managing-apple-notes",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Managing Apple Notes with inotes",
        "body": "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."
      },
      {
        "title": "🔒 Privacy & Security",
        "body": "✅ Open source: Full source code at https://github.com/wangwalk/inotes\n✅ Local-only: All operations run locally via AppleScript; no data leaves your machine\n✅ No network calls: inotes does not connect to any remote servers\n✅ Auditable install: Binary installed via Homebrew from signed release or GitHub Releases\n✅ MIT Licensed: Free and open for inspection and contributions\n⚠️ Requires macOS Automation permission for Notes.app (user grants via System Settings)\n📦 Universal binary: Supports both Apple Silicon (arm64) and Intel (x86_64)"
      },
      {
        "title": "Prerequisites",
        "body": "System Requirements:\n\nmacOS 14+ (Sonoma or later)\nApple Notes.app (comes with macOS)\n\nInstall via Homebrew (recommended):\n\nbrew install wangwalk/tap/inotes\n\nVerify installation:\n\ninotes --version  # Should show: 0.1.2\nwhich inotes      # Should be in /opt/homebrew/bin/ or /usr/local/bin/\n\nManual installation from GitHub Releases:\n\nDownload from GitHub Releases and verify SHA256:\n\ncurl -LO https://github.com/wangwalk/inotes/releases/download/v0.1.2/inotes-0.1.2-universal-apple-darwin.tar.gz\n# Verify checksum from release notes\ntar xzf inotes-0.1.2-universal-apple-darwin.tar.gz\nsudo cp inotes /usr/local/bin/\nsudo chmod +x /usr/local/bin/inotes\n\nCheck permission:\n\ninotes status\n\nIf permission is denied, the user must enable Automation access for their terminal in System Settings > Privacy & Security > Automation > Notes."
      },
      {
        "title": "List notes",
        "body": "inotes                            # recent iCloud notes (default)\ninotes today                      # modified today\ninotes show week                  # modified this week\ninotes show all                   # all notes\ninotes show --folder Work         # notes in a specific folder\ninotes show recent --limit 10    # limit results"
      },
      {
        "title": "List folders",
        "body": "inotes folders"
      },
      {
        "title": "List accounts",
        "body": "inotes accounts"
      },
      {
        "title": "Create a folder",
        "body": "inotes mkfolder \"Projects\"\ninotes mkfolder \"Work Notes\" --account Exchange"
      },
      {
        "title": "Read a note",
        "body": "inotes read 1        # by index from last show output\ninotes read A3F2     # by ID prefix (4+ characters)"
      },
      {
        "title": "Create a note",
        "body": "inotes add --title \"Meeting Notes\" --body \"Action items\" --folder Work"
      },
      {
        "title": "Edit a note",
        "body": "inotes edit 1 --title \"Updated Title\"\ninotes edit 2 --body \"New content\" --folder Projects"
      },
      {
        "title": "Delete a note",
        "body": "inotes delete 1              # with confirmation\ninotes delete 1 --force      # skip confirmation"
      },
      {
        "title": "Search notes",
        "body": "inotes search \"quarterly review\"\ninotes search \"TODO\" --folder Work --limit 10"
      },
      {
        "title": "Multi-account support",
        "body": "By default only iCloud notes are shown. Use --account <name> or --all-accounts to access other accounts.\n\ninotes accounts                    # list available accounts\ninotes show all --account Exchange\ninotes show all --all-accounts"
      },
      {
        "title": "Output formats",
        "body": "FlagDescription(default)Human-readable table--json / -jJSON--plainTab-separated--quiet / -qCount only"
      },
      {
        "title": "Agent usage guidelines",
        "body": "Always use --json when you need to parse output programmatically.\nUse --no-input to disable interactive prompts in non-interactive contexts.\nUse --no-color when capturing output to avoid ANSI escape sequences.\nIdentify notes by index (from the last show output) or by ID prefix (first 4+ hex characters of the note ID).\nRun inotes status first to verify automation permission before attempting other commands.\nThe CLI automatically filters out notes in \"Recently Deleted\" folders across all supported languages."
      },
      {
        "title": "Examples for common tasks",
        "body": "Create daily note:\n\ninotes add --title \"Daily Notes $(date +%Y-%m-%d)\" --body \"## TODO\\n\\n## Done\\n\"\n\nExport all notes to JSON:\n\ninotes show all --json > notes-backup.json\n\nFind notes with specific tag:\n\ninotes search \"#important\" --json | jq '.[] | select(.folder == \"Work\")'\n\nArchive completed notes:\n\ninotes search \"DONE\" --folder Inbox --json | jq -r '.[].id' | while read id; do\n  inotes edit \"$id\" --folder Archive\ndone"
      },
      {
        "title": "Troubleshooting",
        "body": "\"Automation permission denied\"\n\nGo to System Settings > Privacy & Security > Automation\nFind your terminal app (e.g., Terminal.app, iTerm.app)\nEnable access to \"Notes\"\n\n\"Command not found\"\n\nRun which inotes to check if it's in your PATH\nIf using Homebrew: brew doctor and check for warnings\nTry brew reinstall wangwalk/tap/inotes\n\n\"Note not found\" when using index\n\nRun inotes show again to get fresh indices\nUse ID prefix instead: inotes read A3F2\n\nPerformance issues with many notes\n\nUse --limit flag to reduce result set\nFilter by folder: --folder \"Work\"\nUse date filters: today, week, recent"
      },
      {
        "title": "Additional resources",
        "body": "GitHub: https://github.com/wangwalk/inotes\nReleases: https://github.com/wangwalk/inotes/releases\nIssues: https://github.com/wangwalk/inotes/issues\nLicense: MIT"
      }
    ],
    "body": "Managing Apple Notes with inotes\n\ninotes 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.\n\n🔒 Privacy & Security\n✅ Open source: Full source code at https://github.com/wangwalk/inotes\n✅ Local-only: All operations run locally via AppleScript; no data leaves your machine\n✅ No network calls: inotes does not connect to any remote servers\n✅ Auditable install: Binary installed via Homebrew from signed release or GitHub Releases\n✅ MIT Licensed: Free and open for inspection and contributions\n⚠️ Requires macOS Automation permission for Notes.app (user grants via System Settings)\n📦 Universal binary: Supports both Apple Silicon (arm64) and Intel (x86_64)\nPrerequisites\n\nSystem Requirements:\n\nmacOS 14+ (Sonoma or later)\nApple Notes.app (comes with macOS)\n\nInstall via Homebrew (recommended):\n\nbrew install wangwalk/tap/inotes\n\n\nVerify installation:\n\ninotes --version  # Should show: 0.1.2\nwhich inotes      # Should be in /opt/homebrew/bin/ or /usr/local/bin/\n\n\nManual installation from GitHub Releases:\n\nDownload from GitHub Releases and verify SHA256:\n\ncurl -LO https://github.com/wangwalk/inotes/releases/download/v0.1.2/inotes-0.1.2-universal-apple-darwin.tar.gz\n# Verify checksum from release notes\ntar xzf inotes-0.1.2-universal-apple-darwin.tar.gz\nsudo cp inotes /usr/local/bin/\nsudo chmod +x /usr/local/bin/inotes\n\n\nCheck permission:\n\ninotes status\n\n\nIf permission is denied, the user must enable Automation access for their terminal in System Settings > Privacy & Security > Automation > Notes.\n\nCommands\nList notes\ninotes                            # recent iCloud notes (default)\ninotes today                      # modified today\ninotes show week                  # modified this week\ninotes show all                   # all notes\ninotes show --folder Work         # notes in a specific folder\ninotes show recent --limit 10    # limit results\n\nList folders\ninotes folders\n\nList accounts\ninotes accounts\n\nCreate a folder\ninotes mkfolder \"Projects\"\ninotes mkfolder \"Work Notes\" --account Exchange\n\nRead a note\ninotes read 1        # by index from last show output\ninotes read A3F2     # by ID prefix (4+ characters)\n\nCreate a note\ninotes add --title \"Meeting Notes\" --body \"Action items\" --folder Work\n\nEdit a note\ninotes edit 1 --title \"Updated Title\"\ninotes edit 2 --body \"New content\" --folder Projects\n\nDelete a note\ninotes delete 1              # with confirmation\ninotes delete 1 --force      # skip confirmation\n\nSearch notes\ninotes search \"quarterly review\"\ninotes search \"TODO\" --folder Work --limit 10\n\nMulti-account support\n\nBy default only iCloud notes are shown. Use --account <name> or --all-accounts to access other accounts.\n\ninotes accounts                    # list available accounts\ninotes show all --account Exchange\ninotes show all --all-accounts\n\nOutput formats\nFlag\tDescription\n(default)\tHuman-readable table\n--json / -j\tJSON\n--plain\tTab-separated\n--quiet / -q\tCount only\nAgent usage guidelines\nAlways use --json when you need to parse output programmatically.\nUse --no-input to disable interactive prompts in non-interactive contexts.\nUse --no-color when capturing output to avoid ANSI escape sequences.\nIdentify notes by index (from the last show output) or by ID prefix (first 4+ hex characters of the note ID).\nRun inotes status first to verify automation permission before attempting other commands.\nThe CLI automatically filters out notes in \"Recently Deleted\" folders across all supported languages.\nExamples for common tasks\n\nCreate daily note:\n\ninotes add --title \"Daily Notes $(date +%Y-%m-%d)\" --body \"## TODO\\n\\n## Done\\n\"\n\n\nExport all notes to JSON:\n\ninotes show all --json > notes-backup.json\n\n\nFind notes with specific tag:\n\ninotes search \"#important\" --json | jq '.[] | select(.folder == \"Work\")'\n\n\nArchive completed notes:\n\ninotes search \"DONE\" --folder Inbox --json | jq -r '.[].id' | while read id; do\n  inotes edit \"$id\" --folder Archive\ndone\n\nTroubleshooting\n\n\"Automation permission denied\"\n\nGo to System Settings > Privacy & Security > Automation\nFind your terminal app (e.g., Terminal.app, iTerm.app)\nEnable access to \"Notes\"\n\n\"Command not found\"\n\nRun which inotes to check if it's in your PATH\nIf using Homebrew: brew doctor and check for warnings\nTry brew reinstall wangwalk/tap/inotes\n\n\"Note not found\" when using index\n\nRun inotes show again to get fresh indices\nUse ID prefix instead: inotes read A3F2\n\nPerformance issues with many notes\n\nUse --limit flag to reduce result set\nFilter by folder: --folder \"Work\"\nUse date filters: today, week, recent\nAdditional resources\nGitHub: https://github.com/wangwalk/inotes\nReleases: https://github.com/wangwalk/inotes/releases\nIssues: https://github.com/wangwalk/inotes/issues\nLicense: MIT"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/wangwalk/managing-apple-notes",
    "publisherUrl": "https://clawhub.ai/wangwalk/managing-apple-notes",
    "owner": "wangwalk",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}