Craft CLI

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

设置

1. 安装：复制scripts/craft到~/bin/craft并使其可执行
2. 从Craft获取API URL：设置 > 集成 > Craft Connect > 创建链接
3. 设置环境变量：export CRAFT_API_URL='https://connect.craft.do/links/YOUR_LINK/api/v1'

将其添加到shell配置文件中以实现持久化。

命令

文档

craft folders                    # List all folders
craft docs [location]            # List documents (unsorted, trash, templates, daily_notes)
craft doc <id>                   # Get document content by ID
craft daily [date]               # Get daily note (today, yesterday, YYYY-MM-DD)
craft search <term>              # Search across documents
craft create-doc "Title" [folderId]  # Create new document

区块

craft add-block <docId> "markdown"      # Add block to document
craft add-to-daily "markdown" [date]    # Add to daily note (default: today)
craft update-block <blockId> "markdown" # Update existing block
craft delete-block <blockId>...         # Delete block(s)

任务

craft tasks [scope]              # List tasks (inbox, active, upcoming, logbook)
craft add-task "text" [scheduleDate]  # Add task to inbox
craft complete-task <id>         # Mark task as done
craft delete-task <id>           # Delete task

集合

craft collections                # List all collections
craft collection-items <id>      # Get items from collection

笔记

• Markdown内容通过参数传递；如有需要请转义引号
• 日期：今天、昨天，或YYYY-MM-DD
• 任务范围：收件箱（默认），进行中、待处理、日志簿
• 文档位置：未分类、回收站、模板、每日笔记