Taskleef
Manage todos, projects, and kanban boards using the Taskleef CLI. Taskleef.com is a flexible todo application that supports simple task lists, project organization, and kanban board workflows.
Prerequisites
The todo CLI requires:
- -
curl - for making API requests - INLINECODE2 - for parsing JSON responses
- INLINECODE3 environment variable
Authentication
The CLI uses the TASKLEEF_API_KEY environment variable. Users can get their API key from https://taskleef.com.
Optionally, users can use --auth-file flag to specify an auth file:
CODEBLOCK0
Core Commands
Todo Management
List todos:
CODEBLOCK1
Add todos:
CODEBLOCK2
Show todo details:
CODEBLOCK3
Complete todos:
CODEBLOCK4
Delete todos:
CODEBLOCK5
View inbox:
CODEBLOCK6
Subtasks
Add subtasks:
CODEBLOCK7
Projects
List projects:
CODEBLOCK8
Create project:
CODEBLOCK9
Show project details:
CODEBLOCK10
Delete project:
CODEBLOCK11
Add todo to project:
CODEBLOCK12
Remove todo from project:
CODEBLOCK13
Kanban Boards
Show board:
CODEBLOCK14
List boards:
CODEBLOCK15
List column cards:
CODEBLOCK16
Move card:
CODEBLOCK17
Mark card done:
CODEBLOCK18
Assign card:
CODEBLOCK19
Clear column:
CODEBLOCK20
Identifier Matching
Commands accept:
- - ID prefix: First few characters of UUID (e.g.,
abc12) - Title match: Partial, case-insensitive title match (e.g.,
groceries matches "Buy groceries")
Priority Indicators
When listing todos, you'll see:
- - ○ No priority
- ● (green) Low priority
- ● (yellow) Medium priority
- ● (red) High priority
Usage Tips
- 1. Finding items: You can reference todos, projects, boards, columns, and cards by partial title or ID prefix
- Quick workflow: Use
todo "task" for fast task entry - Project organization: Group related todos under projects for better organization
- Kanban boards: Use boards for visual workflow management
- Subtasks: Break down complex tasks into subtasks for better tracking
Examples
CODEBLOCK21
Error Handling
If the TASKLEEF_API_KEY is not set or invalid, commands will fail. Ensure the API key is configured before running commands.
Additional Resources
- - Website: https://taskleef.com
- Generate API key: https://taskleef.com (user dashboard)
Taskleef
使用 Taskleef CLI 管理待办事项、项目和看板。Taskleef.com 是一款灵活的待办事项应用,支持简单的任务列表、项目组织和看板工作流。
前置条件
todo CLI 需要:
- - curl - 用于发起 API 请求
- jq - 用于解析 JSON 响应
- TASKLEEFAPIKEY 环境变量
身份认证
CLI 使用 TASKLEEFAPIKEY 环境变量。用户可以从 https://taskleef.com 获取其 API 密钥。
可选地,用户可以使用 --auth-file 标志指定认证文件:
bash
todo --auth-file ~/.taskleef.auth list
todo -a ~/.taskleef.auth list
核心命令
待办事项管理
列出待办事项:
bash
todo list # 列出待处理的待办事项
todo ls # list 的别名
todo list -a # 列出所有待办事项(包括已完成的)
添加待办事项:
bash
todo add 购买杂货
todo 购买杂货 # 无需 add 关键字的快速添加
查看待办事项详情:
bash
todo show <标题或ID>
完成待办事项:
bash
todo complete <标题或ID>
todo done <标题或ID>
删除待办事项:
bash
todo delete <标题或ID>
todo rm <标题或ID>
查看收件箱:
bash
todo inbox # 列出未分配到任何项目的待办事项
子任务
添加子任务:
bash
todo subtask <父任务标题或ID> 子任务标题
项目
列出项目:
bash
todo project list
创建项目:
bash
todo project add 项目名称
查看项目详情:
bash
todo project show <项目名称或ID>
删除项目:
bash
todo project delete <项目名称或ID>
向项目添加待办事项:
bash
todo project add-todo <项目名称或ID> <待办事项标题或ID>
从项目移除待办事项:
bash
todo project remove-todo <项目名称或ID> <待办事项标题或ID>
看板
显示看板:
bash
todo board # 显示默认看板(ASCII 视图)
todo board show <看板名称或ID> # 显示特定看板
列出看板:
bash
todo board list
列出列卡片:
bash
todo board column <列名称或ID>
移动卡片:
bash
todo board move <卡片标题或ID> <列名称或ID>
标记卡片为已完成:
bash
todo board done <卡片标题或ID>
分配卡片:
bash
todo board assign <卡片标题或ID>
清空列:
bash
todo board clear <列名称或ID>
标识符匹配
命令接受:
- - ID 前缀:UUID 的前几个字符(例如 abc12)
- 标题匹配:部分、不区分大小写的标题匹配(例如 杂货 匹配 购买杂货)
优先级指示符
列出待办事项时,您会看到:
- - ○ 无优先级
- ●(绿色)低优先级
- ●(黄色)中优先级
- ●(红色)高优先级
使用技巧
- 1. 查找项目:可以通过部分标题或 ID 前缀引用待办事项、项目、看板、列和卡片
- 快速工作流:使用 todo 任务 快速输入任务
- 项目组织:将相关待办事项分组到项目下以便更好地组织
- 看板:使用看板进行可视化工作流管理
- 子任务:将复杂任务分解为子任务以便更好地跟踪
示例
bash
添加并完成一个待办事项
todo add 审查拉取请求
todo done 拉取请求
创建项目并添加待办事项
todo project add 网站改版
todo project add-todo 网站 修复登录
查看看板并移动卡片
todo board
todo board move 功能A 已完成
错误处理
如果 TASKLEEFAPIKEY 未设置或无效,命令将失败。请确保在运行命令前配置好 API 密钥。
其他资源
- - 网站:https://taskleef.com
- 生成 API 密钥:https://taskleef.com(用户仪表板)