名称： taskleef
描述： 当需要通过 Taskleef.com 管理待办事项、任务、项目或看板时使用。支持添加、列出、完成、删除待办事项，使用项目进行组织，以及管理看板。适用于用户希望跟踪任务、管理待办事项列表、按项目组织工作或使用看板工作流的场景。
元数据： {"clawdbot":{"emoji":"✅","requires":{"bins":["todo","curl","jq"],"env":["TASKLEEF_API_KEY"]},"primaryEnv":"TASKLEEF_API_KEY","homepage":"https://taskleef.com","install":[{"id":"todo-cli","kind":"download","url":"https://raw.githubusercontent.com/Xatter/taskleef/main/taskleef-cli/todo","bins":["todo"],"label":"安装 Taskleef CLI (todo)"},{"id":"jq-brew","kind":"brew","formula":"jq","bins":["jq"],"label":"通过 Homebrew 安装 jq","os":["darwin"]},{"id":"jq-linux-amd64","kind":"download","url":"https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-linux-amd64","bins":["jq"],"label":"安装 jq (Linux x86_64)","os":["linux"]},{"id":"jq-linux-arm64","kind":"download","url":"https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-linux-arm64","bins":["jq"],"label":"安装 jq (Linux ARM64)","os":["linux"]}]}}

Taskleef

使用 Taskleef CLI 管理待办事项、项目和看板。Taskleef.com 是一个灵活的待办事项应用，支持简单的任务列表、项目组织和看板工作流。

先决条件

todo CLI 需要：
- curl - 用于发起 API 请求
- jq - 用于解析 JSON 响应
- TASKLEEF_API_KEY 环境变量

身份验证

CLI 使用 TASKLEEF_API_KEY 环境变量。用户可以从 https://taskleef.com 获取其 API 密钥。

可选地，用户可以使用 --auth-file 标志指定认证文件：

todo --auth-file ~/.taskleef.auth list
todo -a ~/.taskleef.auth list

核心命令

待办事项管理

列出待办事项：

todo list           # 列出未完成的待办事项
todo ls             # list 的别名
todo list -a        # 列出所有待办事项（包括已完成）

添加待办事项：

todo add "购买杂货"
todo "购买杂货"    # 快速添加（无需 'add' 关键字）

查看待办事项详情：

todo show <标题或ID>

完成待办事项：

todo complete <标题或ID>
todo done <标题或ID>

删除待办事项：

todo delete <标题或ID>
todo rm <标题或ID>

查看收件箱：

todo inbox    # 列出未分配到任何项目的待办事项

子任务

添加子任务：

todo subtask <父任务标题或ID> "子任务标题"

项目管理

列出项目：

todo project list

创建项目：

todo project add "项目名称"

查看项目详情：

todo project show <项目名称或ID>

删除项目：

todo project delete <项目名称或ID>

将待办事项添加到项目：

todo project add-todo <项目名称或ID> <待办事项标题或ID>

从项目中移除待办事项：

todo project remove-todo <项目名称或ID> <待办事项标题或ID>

看板管理

查看看板：

todo board                           # 查看默认看板（ASCII 视图）
todo board show <看板名称或ID>   # 查看特定看板

列出所有看板：

todo board list

列出列中的卡片：

todo board column <列名称或ID>

移动卡片：

todo board move <卡片标题或ID> <列名称或ID>

标记卡片为完成：

todo board done <卡片标题或ID>

分配卡片：

todo board assign <卡片标题或ID>

清空列：

todo board clear <列名称或ID>

标识符匹配规则

命令接受：
- ID 前缀：UUID 的前几个字符（例如 abc12）
- 标题匹配：部分、不区分大小写的标题匹配（例如 groceries 可以匹配 "Buy groceries"）

优先级指示器

列出待办事项时，您会看到：
- ○ 无优先级
- ● (绿色) 低优先级
- ● (黄色) 中优先级
- ● (红色) 高优先级

使用技巧

1. 查找项目：可以通过部分标题或 ID 前缀来引用待办事项、项目、看板、列和卡片。
2. 快速工作流：使用 todo "任务" 快速录入任务。
3. 项目组织：将相关待办事项分组到项目下，以便更好地组织。
4. 看板：使用看板进行可视化工作流管理。
5. 子任务：将复杂任务分解为子任务，以便更好地跟踪。

示例

# 添加并完成一个待办事项
todo add "审查拉取请求"
todo done "拉取请求"

# 创建项目并添加待办事项
todo project add "网站改版"
todo project add-todo "网站" "修复登录"

# 查看看板并移动卡片
todo board
todo board move "功能 A" "已完成"

错误处理

如果 TASKLEEF_API_KEY 未设置或无效，命令将失败。运行命令前请确保已正确配置 API 密钥。

其他资源

• 网站：https://taskleef.com
• 生成 API 密钥：https://taskleef.com（用户仪表板）