lark-task

Manage Feishu tasks, tasklists, and task agents via the lark-cli command line.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/TrayMachi/dotfiles --skill lark-task-traymachi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-task
Source: https://github.com/TrayMachi/dotfiles/tree/main/agents/skills/lark-task
Command: npx skills add https://github.com/TrayMachi/dotfiles --skill lark-task-traymachi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lark-cli, and includes references (resource) components.

What problem does it solve? Managing Feishu (Lark) tasks manually through the web UI is slow when you need to create todos, track progress, organize tasklists, or assign work to collaborators at scale. This Skill lets an AI agent perform all Feishu Task operations directly through the lark-cli command line. ## Core Features & Use Cases - Full Task Lifecycle: Create, update, complete, reopen, comment on, and search tasks, with support for due dates, reminders, subtasks, followers, and file attachments up to 50 MB. - Tasklist Organization: Create tasklists, batch-add tasks, manage list members and custom sections, and search lists by keyword or creator. - Task Agents & Events: Register or unregister task agents, update agent profile data, append task step records, and subscribe to task update events via WebSocket. - Use Case: Ask the agent to "create a task 'Prepare Q2 report' assigned to me, due next Friday, in my Launch Checklist list" and it resolves your open_id, picks the right shortcut, and returns the task URL. ## Quick Start Ask the assistant to create a Feishu task with a summary, due date, and assignee, for example: create a task called "Review launch plan" assigned to me and due in two days.

Frequently Asked Questions about lark-task

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Feishu task from the command line?

Use lark-cli task +create with a --summary flag, optionally adding --description, --assignee, --due, and --tasklist-id. To assign the task to yourself, first get your open_id from lark-cli auth status and pass it to --assignee.

How do I list my pending Feishu tasks?

Run lark-cli task +get-my-tasks --complete=false to list only incomplete tasks assigned to you. You can add --due-end to bound the due date, and the command paginates automatically up to 20 pages by default.

What is the difference between task search and listing related tasks in Feishu?

Use +search only when you have an actual query keyword like a task name. For scope-only filters such as "created by me" or "this year", prefer +get-related-tasks or +get-my-tasks, which list tasks without requiring a keyword.

Can I upload file attachments to a Feishu task?

Yes, use lark-cli task +upload-attachment with --resource-id and --file. Each call uploads one file up to 50 MB, the path must be relative to the current working directory, and task agents require --resource-type task_delivery.

Why does a Feishu task API call fail with an app identity?

Endpoints like +get-my-tasks, +get-related-tasks, and +search require a user identity and fail when called as an app. Also, tenant_access_token cannot add task members across tenants, so use --as user for these operations.

When should task reminders be set relative to the due date?

Reminders require the task to have a due date first. Use lark-cli task +reminder --task-id <guid> --set "30" or "1h" to fire that long before the due time, and --remove true to clear all reminders.