Communitygithub.com

V4TIME/V4SKILL

通过 memo CLI 管理 Apple Notes:创建、搜索、编辑笔记。

V4SKILL 是什么?

该技能通过 `memo` 命令行工具,让 AI 代理能够直接管理 macOS 上的 Apple Notes。其核心价值在于实现跨 Apple 设备的笔记同步——任何通过终端创建的笔记都会自动通过 iCloud 同步到所有 Apple 设备。支持创建、查看、搜索、编辑、删除和移动笔记,以及导出为 Markdown/HTML。主要面向需要将信息持久化到系统级笔记应用的用户,特别是当用户要求跨设备访问时。但需要注意,该技能仅支持 macOS,且无法处理包含图片或附件的笔记。如果用户需要 Obsidian 知识库或仅代理使用的临时笔记,建议分别使用 `obsidian` 技能和 `memory` 工具。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/V4TIME/V4SKILL/tree/HEAD/apple/apple-notes

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Apple Notes

使用 memo 从终端直接管理 Apple Notes。笔记通过 iCloud 在所有 Apple 设备之间同步。

前提条件

  • macOS 且已安装 Notes.app
  • 安装:brew tap antoniorodr/memo && brew install antoniorodr/memo/memo
  • 提示时授予 Notes.app 自动化权限(系统设置 → 隐私 → 自动化)

使用场景

  • 用户要求创建、查看或搜索 Apple Notes
  • 将信息保存到 Notes.app 以实现跨设备访问
  • 将笔记组织到文件夹中
  • 将笔记导出为 Markdown/HTML

不使用场景

  • Obsidian 知识库管理 → 使用 obsidian 技能
  • Bear Notes → 单独应用(此处不支持)
  • 仅代理使用的快速笔记 → 改用 memory 工具

快速参考

查看笔记

memo notes                        # 列出所有笔记
memo notes -f "文件夹名"          # 按文件夹过滤
memo notes -s "查询"              # 搜索笔记(模糊匹配)

创建笔记

memo notes -a                     # 添加笔记(打开 $EDITOR)
memo notes -a -f "文件夹名"       # 向指定文件夹添加笔记

-a/--add 是裸标志——它会打开你的 $EDITOR 来撰写笔记;它不接受标题参数。使用 -f/--folder 指定文件夹。先设置 $EDITOR(例如 export EDITOR=vim)。

编辑笔记

memo notes -e                     # 交互式选择要编辑的笔记

删除笔记

memo notes -d                     # 交互式选择要删除的笔记

移动笔记

memo notes -m                     # 将笔记移动到文件夹(交互式)

导出笔记

memo notes -ex                    # 导出为 HTML/Markdown

限制

  • 无法编辑包含图片或附件的笔记
  • 交互式提示需要终端访问(在需要时使用 pty=true)
  • 仅限 macOS——需要 Apple Notes.app

规则

  1. 当用户需要跨设备同步(iPhone/iPad/Mac)时,优先使用 Apple Notes
  2. 对于不需要同步的代理内部笔记,使用 memory 工具
  3. 对于 Markdown 原生的知识管理,使用 obsidian 技能

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

相关技能