Wrike CLI

管理 Wrike 中的任务、项目、文件夹和评论。所有命令均返回 JSON 格式结果：成功时为 {"ok": true, "data": ...}，失败时为 {"ok": false, "error": "..."}。

配置

claw-wrike config set --token 
# 自动识别 US/EU 数据中心。Token 将保存在 ~/.claw-wrike/config.json 中

快速参考

claw-wrike <实体> <命令> [--标志]

账户与空间（Spaces）

claw-wrike account                          # 账户信息（名称、根文件夹 ID 等）
claw-wrike space list                       # 列出所有空间
claw-wrike space get --id               # 获取指定空间详情

文件夹与项目

Wrike 将文件夹与项目视为同一类实体。项目即具有额外属性（如负责人、起止日期、状态等）的文件夹。

claw-wrike folder list                      # 列出所有文件夹（树形结构）
claw-wrike folder list --space          # 列出指定空间内的文件夹
claw-wrike folder list --parent         # 列出子文件夹
claw-wrike folder get --id              # 获取文件夹详细信息

claw-wrike folder create --parent  --title "文件夹名称"
claw-wrike folder create --parent  --title "项目名称" --project
claw-wrike folder create --parent  --title "项目名称" --project --owner  --start-date 2026-03-01 --end-date 2026-06-01
claw-wrike folder create --parent  --title "文件夹名称" --dry-run   # 预览创建操作，不实际执行

claw-wrike folder update --id  --title "新标题"
claw-wrike folder update --id  --description "新描述"
claw-wrike folder update --id  --add-parent               # 移入另一父级文件夹
claw-wrike folder update --id  --remove-parent            # 从某父级文件夹中移除
claw-wrike folder update --id  --dry-run                            # 预览更新操作，不实际执行

claw-wrike folder delete --id                                       # 移入回收站
claw-wrike folder delete --id  --dry-run                            # 预览删除操作，不实际执行

任务

claw-wrike task list                        # 列出任务（默认：最多 100 条，状态为 Active）
claw-wrike task list --folder           # 指定文件夹/项目中的任务
claw-wrike task list --space            # 指定空间中的任务
claw-wrike task list --status Active        # 状态筛选：Active|Completed|Deferred|Cancelled
claw-wrike task list --assignee "Jane"      # 按负责人姓名筛选
claw-wrike task list --importance High      # 重要性筛选：High|Normal|Low
claw-wrike task list --limit 20             # 限制返回数量

claw-wrike task get --id                # 获取任务完整详情（含描述、自定义字段等）

claw-wrike task create --folder  --title "任务名称"
claw-wrike task create --folder  --title "任务名称" --assignee "Jane" --due 2026-03-01 --importance High
claw-wrike task create --folder  --title "任务名称" --dry-run   # 预览创建操作，不实际执行

claw-wrike task update --id  --title "新标题"
claw-wrike task update --id  --add-assignee "Jane"
claw-wrike task update --id  --remove-assignee "Jane"
claw-wrike task update --id  --due 2026-04-01 --importance Low
claw-wrike task update --id  --status 
claw-wrike task update --id  --dry-run                           # 预览更新操作，不实际执行

claw-wrike task delete --id                                      # 移入回收站
claw-wrike task delete --id  --dry-run                           # 预览删除操作，不实际执行

评论

claw-wrike comment list --task          # 列出某任务下的所有评论
claw-wrike comment add --task  --text "评论内容"
claw-wrike comment update --id  --text "更新后的内容"
claw-wrike comment delete --id 

联系人、工作流、自定义字段

claw-wrike contact list                     # 列出账户内所有联系人（用户）
claw-wrike contact get --id             # 获取单个联系人详情
claw-wrike workflow list                    # 列出含自定义状态的工作流
claw-wrike customfield list                 # 列出所有自定义字段定义

工具命令

claw-wrike lookup --permalink          # 将 Wrike 永久链接解析为对应任务详情
claw-wrike cache refresh                    # 强制刷新缓存的联系人/工作流/字段数据
claw-wrike config show                      # 显示当前配置（Token 已脱敏）

重要说明

• ID：Wrike API 使用的 ID 是类似 IEABMHYCI5P7AYDW 的字母数字字符串，不是 永久链接 URL 中出现的数字 ID。
• 负责人解析：可使用姓名（如 "Jane"、"Jane Doe"）或 ID。姓名通过缓存的联系人列表进行匹配解析。
• 自定义状态：使用 claw-wrike workflow list 查找自定义状态 ID，再将其传给 --status 参数。
• 文件夹 = 项目：项目本质上是带有 project 属性的文件夹。对两者均使用 folder 相关命令操作。
• 任务可拥有多个父级：一个任务可同时属于多个文件夹或项目。
• Dry run（预览模式）：在 create 或 update 命令中添加 --dry-run，可查看将发出的 API 请求而不实际执行。
• 速率限制：约 400 次请求/分钟。CLI 会自动处理限流及重试逻辑。

执行任何操作前，请务必

1. 使用 claw-wrike space list 或 claw-wrike folder list 查找目标容器（空间或文件夹）ID；
2. 使用 claw-wrike workflow list 查看可用状态，再修改任务状态；
3. 使用 claw-wrike task get --id 查阅任务当前状态，再执行更新操作。

切勿

• 猜测任务或文件夹 ID —— 务必先通过查询获取；
• 未查阅任务当前状态就直接更新；
• 未经用户确认即批量修改任务。