taskleef – OpenClaw Skill

---

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 requests
• jq - for parsing JSON responses
• TASKLEEF_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           # List pending todos
todo ls             # Alias for list
todo list -a        # List all todos including completed

Add todos:

todo add "Buy groceries"
todo "Buy groceries"    # Quick add without 'add' keyword

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    # List todos not assigned to any project

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                           # Show default board (ASCII view)
todo board show <board-name-or-id>   # Show specific board

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

1. Finding items: You can reference todos, projects, boards, columns, and cards by partial title or ID prefix
2. Quick workflow: Use todo "task" for fast task entry
3. Project organization: Group related todos under projects for better organization
4. Kanban boards: Use boards for visual workflow management
5. Subtasks: Break down complex tasks into subtasks for better tracking

Examples

# Add and complete a todo
todo add "Review pull request"
todo done "pull request"

# Create a project and add todos
todo project add "Website Redesign"
todo project add-todo "Website" "Fix login"

# View kanban board and move cards
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

• Website: https://taskleef.com
• Generate API key: https://taskleef.com (user dashboard)

Taskleef Skill for Clawdbot

A Clawdbot skill for managing todos, projects, and kanban boards using Taskleef.com.

Installation

clawdhub install taskleef

Prerequisites

This skill requires the following to be installed:

• todo CLI - The Taskleef command-line interface (auto-installed via skill installer)
• curl - For making API requests (usually pre-installed)
• jq - For parsing JSON responses (auto-installed via skill installer, or install via package manager for best compatibility)

Manual Installation (Optional)

The skill includes auto-installers for todo and jq, but you can also install them manually:

jq (via package manager - recommended for architecture compatibility):

# macOS
brew install jq

# Ubuntu/Debian
sudo apt-get install jq

# CentOS/RHEL
sudo yum install jq

# Alpine
apk add jq

todo CLI:

# Clone the repository
git clone https://github.com/Xatter/taskleef.git
cd taskleef/taskleef-cli
chmod +x todo

# Add to PATH (add to ~/.bashrc or ~/.zshrc)
export PATH="$PATH:/path/to/taskleef/taskleef-cli"

Configuration

Get Your API Key

1. Visit taskleef.com
2. Generate an API key from your user dashboard

Set Environment Variable

Add to your Clawdbot configuration (~/.clawdbot/clawdbot.json):

{
  "skills": {
    "entries": {
      "taskleef": {
        "enabled": true,
        "apiKey": "your-api-key-here"
      }
    }
  }
}

Or set the environment variable:

export TASKLEEF_API_KEY=your-api-key-here

Features

• Todo Management: Add, list, complete, and delete todos
• Projects: Organize todos into projects
• Kanban Boards: Visual workflow management with boards and columns
• Subtasks: Break down complex tasks
• Flexible Search: Find items by partial title or ID prefix
• Inbox View: See unorganized todos

Usage

Once installed, the agent can manage your Taskleef todos through natural language:

• "Add a todo to buy groceries"
• "Show me my pending todos"
• "Complete the pull request todo"
• "Create a project called Website Redesign"
• "Show my kanban board"
• "Move the Feature A card to Done"

License

MIT