名称： drafts
描述： 通过 macOS 命令行管理 Drafts 应用笔记。可创建、查看、列出、编辑、追加、前置文本，并对草稿执行操作。适用于用户要求创建笔记、列出草稿、搜索草稿或管理 Drafts 收件箱的场景。重要提示：此功能需在 macOS 上运行 Drafts 应用。
主页： https://github.com/nerveband/drafts
元数据： {"clawdbot":{"emoji":"📋","os":["darwin"],"requires":{"bins":["drafts"]}}}

Drafts CLI

在 macOS 终端中管理 Drafts 笔记。

重要前提条件

本 CLI 仅适用于 macOS，且 Drafts 应用必须处于运行状态。

• 仅限 macOS：依赖 AppleScript，无法在 Linux/Windows 上运行
• Drafts 必须正在运行：应用需打开才能执行任何命令
• 需要 Drafts Pro 订阅：自动化功能需 Pro 版本支持

若命令失败或无响应，请先检查：open -a Drafts

安装

通过 Go 安装：

go install github.com/nerveband/drafts/cmd/drafts@latest

或从源码构建：

git clone https://github.com/nerveband/drafts
cd drafts && go build ./cmd/drafts

命令

创建草稿

# 简单创建
drafts create "周一会议记录"

# 添加标签
drafts create "购物清单" -t groceries -t todo

# 标记为重要
drafts create "紧急提醒" -f

# 创建到归档中
drafts create "参考笔记" -a

列出草稿

# 列出收件箱（默认）
drafts list

# 列出已归档草稿
drafts list -f archive

# 列出已删除草稿
drafts list -f trash

# 列出所有草稿
drafts list -f all

# 按标签筛选
drafts list -t mytag

获取草稿

# 获取特定草稿
drafts get <uuid>

# 获取当前活动草稿（Drafts 中正打开的）
drafts get

修改草稿

# 前置文本
drafts prepend "新增首行内容" -u <uuid>

# 追加文本
drafts append "末尾添加内容" -u <uuid>

# 替换全部内容
drafts replace "全新内容" -u <uuid>

在编辑器中编辑

drafts edit <uuid>

执行操作

# 对文本执行操作
drafts run "Copy" "要复制到剪贴板的文本"

# 对现有草稿执行操作
drafts run "Copy" -u <uuid>

获取架构信息

# 获取完整架构（用于 LLM 集成）
drafts schema

# 获取特定命令的架构
drafts schema create

输出格式

JSON（默认）：所有命令返回结构化 JSON：

{
  "success": true,
  "data": {
    "uuid": "ABC123",
    "content": "笔记内容",
    "title": "笔记标题",
    "tags": ["tag1", "tag2"],
    "folder": "inbox"
  }
}

纯文本：人类可读格式：

drafts list --plain

常用工作流

快速记录

drafts create "记得明天打电话给牙医" -t reminder

每日日志

drafts append "$(date): 完成项目评审" -u <journal-uuid>

搜索与查看

# 列出带特定标签的所有草稿
drafts list -t work

# 获取草稿完整内容
drafts get <uuid>

故障排除

命令失败或返回空结果：
1. Drafts 是否在运行？→ open -a Drafts
2. 是否激活了 Drafts Pro？→ 自动化功能需 Pro 版本
3. 是否授予了权限？→ 系统设置 > 隐私与安全性 > 自动化

命令无响应：
- 检查 Drafts 是否正在显示对话框

注意事项

• 仅限 macOS（基于 AppleScript）
• Drafts 应用必须处于运行状态
• 需要 Drafts Pro 订阅
• 所有 UUID 均为 Drafts 生成的标识符
• 标签区分大小写

版本

最新版（通过 go install 安装）