名称： craft
描述： 通过命令行管理 Craft 笔记、文档和任务。当用户要求添加笔记、创建文档、管理任务、搜索 Craft 文档或处理每日笔记时使用。Craft 是一款适用于 macOS/iOS 的笔记应用。
元数据： {"clawdbot":{"install":[{"id":"craft-cli","kind":"script","path":"scripts/craft","dest":"~/bin/craft","label":"安装 Craft CLI"}]}}

Craft CLI

与 Craft.do 的文档、内容块和任务进行交互。

安装与配置

1. 安装 CLI：将 scripts/craft 复制到 ~/bin/craft 并赋予可执行权限。
2. 获取 API 链接：在 Craft 应用中，进入 设置 > 集成 > Craft Connect > 创建链接。
3. 设置环境变量：export CRAFT_API_URL='https://connect.craft.do/links/你的链接/api/v1'

建议将环境变量设置添加到 shell 配置文件（如 ~/.zshrc 或 ~/.bashrc）中以便永久生效。

命令参考

文档管理

craft folders                    # 列出所有文件夹
craft docs [位置]                # 列出文档（可选位置：unsorted, trash, templates, daily_notes）
craft doc <文档ID>               # 根据 ID 获取文档内容
craft daily [日期]               # 获取每日笔记（支持 today, yesterday 或 YYYY-MM-DD 格式）
craft search <关键词>            # 跨文档搜索
craft create-doc "标题" [文件夹ID] # 创建新文档

内容块操作

craft add-block <文档ID> "markdown内容"      # 向文档添加内容块
craft add-to-daily "markdown内容" [日期]     # 添加到每日笔记（默认今天）
craft update-block <块ID> "markdown内容"     # 更新现有内容块
craft delete-block <块ID>...                 # 删除一个或多个内容块

任务管理

craft tasks [范围]               # 列出任务（可选范围：inbox, active, upcoming, logbook）
craft add-task "任务内容" [计划日期] # 添加任务到收件箱
craft complete-task <任务ID>     # 标记任务为已完成
craft delete-task <任务ID>       # 删除任务

集合

craft collections                # 列出所有集合
craft collection-items <集合ID>  # 获取集合中的项目

使用说明

• Markdown 内容：作为参数传递，若内容包含引号请进行转义。
• 日期格式：支持 today、yesterday 或 YYYY-MM-DD。
• 任务范围：inbox（默认）、active、upcoming、logbook。
• 文档位置：unsorted、trash、templates、daily_notes。