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)