AgentSkillsCN

apple-notes

在macOS上的Apple Notes中读取、搜索、列出、创建并删除笔记。当用户想要了解自己的笔记内容、将重要信息保存到Notes,或在Apple Notes中查找曾经记录的内容时,此技能便能派上用场。

SKILL.md
--- frontmatter
name: apple-notes
description: Reads, searches, lists, creates, and deletes notes in Apple Notes on macOS. Use when the user asks about their notes, wants to save information to Notes, or needs to find something they wrote in Apple Notes.

Apple Notes

Interacts with Apple Notes via the @peerasak-u/apple-notes CLI.

Quick Reference

Run commands

bash
bunx @peerasak-u/apple-notes <command> [args]
CommandUsage
search <query>Search notes by body content
list <query>List notes by title (returns indexes)
read <title> [folder]Read note content
read-index <query> <index>Read by index from list result
recent [count] [folder]Get recent notes (default: 5)
create <title> <body> [folder]Create note from Markdown
delete <title> [folder]Delete note (exact match)
move <title> <destination> [source]Move note to folder

Full command details: See references/COMMANDS.md

Common Workflows

Find and read a note

bash
bunx @peerasak-u/apple-notes list "budget"
bunx @peerasak-u/apple-notes read-index "budget" 2

Create a note

bash
bunx @peerasak-u/apple-notes create "Meeting Notes" "# Agenda\n- Item 1\n- Item 2" "Work"

Check recent activity

bash
bunx @peerasak-u/apple-notes recent 10

Output Format

  • Note content returns as Markdown
  • If HTML conversion fails, output starts with [RAW_HTML]
  • Errors return strings starting with Error:

Folder Paths

Specify folders as simple names ("Work") or nested paths ("Work/Projects/2024").