Craft CLI 技能

通过craftCLI 工具与 Craft 文档交互。快速、节省令牌、支持LLM。

安装

craftCLI 二进制文件应安装在/usr/local/bin/craft。如果未安装：

配置

curl -L https://github.com/nerveband/craft-cli/releases/download/v1.0.0/craft-darwin-arm64 -o craft
chmod +x craft
sudo mv craft /usr/local/bin/

有两个可用的 Craft 空间：

wavedepth 空间（商务）

个人空间

~/clawd/skills/craft-cli/craft config set-api https://connect.craft.do/links/5VruASgpXo0/api/v1

快速切换（辅助脚本）

~/clawd/skills/craft-cli/craft config set-api https://connect.craft.do/links/HHRuPxZZTJ6/api/v1

检查当前配置：

# Switch to wavedepth space
~/clawd/skills/craft-cli/craft-helper.sh wavedepth

# Switch to personal space
~/clawd/skills/craft-cli/craft-helper.sh personal

# Check current space
~/clawd/skills/craft-cli/craft-helper.sh current

命令

~/clawd/skills/craft-cli/craft config get-api

列出文档

搜索文档

# JSON format (default - LLM-friendly)
~/clawd/skills/craft-cli/craft list

# Human-readable table
~/clawd/skills/craft-cli/craft list --format table

# Markdown format
~/clawd/skills/craft-cli/craft list --format markdown

获取文档

# Search for documents
~/clawd/skills/craft-cli/craft search "query terms"

# With table output
~/clawd/skills/craft-cli/craft search "query" --format table

创建文档

# Get document by ID (JSON)
~/clawd/skills/craft-cli/craft get <document-id>

# Save to file
~/clawd/skills/craft-cli/craft get <document-id> --output document.md

# Different format
~/clawd/skills/craft-cli/craft get <document-id> --format markdown

更新文档

# Create with title only
~/clawd/skills/craft-cli/craft create --title "My New Document"

# Create from file
~/clawd/skills/craft-cli/craft create --title "My Document" --file content.md

# Create with inline markdown
~/clawd/skills/craft-cli/craft create --title "Quick Note" --markdown "# Hello\nThis is content"

# Create as child of another document
~/clawd/skills/craft-cli/craft create --title "Child Doc" --parent <parent-id>

删除文档

# Update title
~/clawd/skills/craft-cli/craft update <document-id> --title "New Title"

# Update from file
~/clawd/skills/craft-cli/craft update <document-id> --file updated-content.md

# Update with inline markdown
~/clawd/skills/craft-cli/craft update <document-id> --markdown "# Updated\nNew content"

# Update both title and content
~/clawd/skills/craft-cli/craft update <document-id> --title "New Title" --file content.md

Delete Document

~/clawd/skills/craft-cli/craft delete <document-id>

信息命令

# Show API info and recent documents
~/clawd/skills/craft-cli/craft info

# List all available documents
~/clawd/skills/craft-cli/craft docs

版本

~/clawd/skills/craft-cli/craft version

输出格式

• json（默认）：机器可读的JSON格式，适用于LLM和脚本
• table：人类可读的表格格式
• markdown：Markdown格式的输出

可在配置中设置默认格式，或对每条命令使用--format标志。

API URL覆盖

为任何命令覆盖已配置的API URL：

~/clawd/skills/craft-cli/craft list --api-url https://connect.craft.do/links/ANOTHER_LINK/api/v1

错误处理

CLI提供清晰的错误信息和退出代码：

• 退出代码 0：成功
• 退出代码 1：用户错误（输入无效、参数缺失）
• 退出代码 2：API错误（服务器端问题）
• 退出代码 3配置错误

常见错误：

• 认证失败。请检查 API URL- 无效/未授权的 API URL
• 资源未找到- 文档 ID 不存在
• 超出速率限制。请稍后重试- 请求过多
• 未配置 API URL。请先运行 'craft config set-api <url>'- 缺少配置

使用示例

工作流程：列出与搜索

# List all documents in wavedepth space
~/clawd/skills/craft-cli/craft config set-api https://connect.craft.do/links/5VruASgpXo0/api/v1
~/clawd/skills/craft-cli/craft list --format table

# Search for specific documents
~/clawd/skills/craft-cli/craft search "proposal" --format table

工作流程：创建与更新

# Create a new document
~/clawd/skills/craft-cli/craft create --title "Project Notes" --markdown "# Initial notes\n\nStart here."

# Get the document ID from output, then update
~/clawd/skills/craft-cli/craft update <doc-id> --title "Updated Project Notes"

# Verify the update
~/clawd/skills/craft-cli/craft get <doc-id> --format markdown

工作流程：导出文档

# Get a specific document and save to file
~/clawd/skills/craft-cli/craft get <doc-id> --output exported-notes.md

LLM 集成

# Get all documents as JSON (pipe to processing)
~/clawd/skills/craft-cli/craft list | jq '.[] | {id, title}'

# Search and extract specific fields
~/clawd/skills/craft-cli/craft search "meeting" | jq '.[].title'

提示

1. 默认使用 JSON 格式供 LLM 使用（这是默认设置）
2. 使用表格格式当向人类展示结果时
3. 检查配置在执行操作前：craft config get-api
4. 轻松切换空间通过craft config set-api <url>
5. 临时覆盖 API URL使用--api-url标志而非修改配置

GitHub 仓库

源代码与文档：https://github.com/nerveband/craft-cli

版本

当前版本：1.6.0