| name | taskleef |
| description | Use when managing todos, tasks, projects, or kanban boards via Taskleef.com. Supports adding, listing, completing, deleting todos, organizing with projects, and managing kanban boards. Use when the user wants to track tasks, manage their todo list, organize work by projects, or use kanban workflows. |
| metadata | {"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":"Install Taskleef CLI (todo)"},{"id":"jq-brew","kind":"brew","formula":"jq","bins":["jq"],"label":"Install jq via Homebrew","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":"Install 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":"Install jq (Linux ARM64)","os":["linux"]}]}} |
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 requestsjq - for parsing JSON responsesTASKLEEF_API_KEY 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:
todo --auth-file ~/.taskleef.auth list
todo -a ~/.taskleef.auth list
Core Commands
Todo Management
List todos:
todo list
todo ls
todo list -a
Add todos:
todo add "Buy groceries"
todo "Buy groceries"
Show todo details:
todo show <title-or-id>
Complete todos:
todo complete <title-or-id>
todo done <title-or-id>
Delete todos:
todo delete <title-or-id>
todo rm <title-or-id>
View inbox:
todo inbox
Subtasks
Add subtasks:
todo subtask <parent-title-or-id> "Subtask title"
Projects
List projects:
todo project list
Create project:
todo project add "Project Name"
Show project details:
todo project show <project-name-or-id>
Delete project:
todo project delete <project-name-or-id>
Add todo to project:
todo project add-todo <project-name-or-id> <todo-title-or-id>
Remove todo from project:
todo project remove-todo <project-name-or-id> <todo-title-or-id>
Kanban Boards
Show board:
todo board
todo board show <board-name-or-id>
List boards:
todo board list
List column cards:
todo board column <column-name-or-id>
Move card:
todo board move <card-title-or-id> <column-name-or-id>
Mark card done:
todo board done <card-title-or-id>
Assign card:
todo board assign <card-title-or-id>
Clear column:
todo board clear <column-name-or-id>
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
- 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
todo add "Review pull request"
todo done "pull request"
todo project add "Website Redesign"
todo project add-todo "Website" "Fix login"
todo board
todo board move "Feature A" "Done"
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
