wecomcli-todo

Manage WeCom todos via wecom-cli with create, list, update, finish, and delete operations.

287|46|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/YanHaidao/wecom --skill wecomcli-todo-yanhaidao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wecomcli-todo
Source: https://github.com/YanHaidao/wecom/tree/main/skills/wecomcli-todo
Command: npx skills add https://github.com/YanHaidao/wecom --skill wecomcli-todo-yanhaidao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It lets users manage WeCom (Enterprise WeChat) todo items conversationally—creating, querying, updating, completing, and deleting todos—without manually operating the WeCom app or memorizing API parameters. ## Core Features & Use Cases - Full Todo Lifecycle: Create todos with assignees and deadlines, list and filter by time range, status, or keywords, update titles/descriptions/followers/deadlines, mark finished (self or all), and delete or exit todos. - Deadline & Reminder Semantics: Structured deadline object (date vs datetime) with remind_at_deadline handling, including guidance for 'remind X minutes early' requests that the API cannot directly set. - Idempotent, Safe Operations: Locates todos via list before mutating, distinguishes creator-delete vs participant-exit semantics, and avoids duplicate finish calls. - Use Case: A user says 'Remind me to prepare the weekly report Friday at 9am and assign it to vincentwei'—the skill resolves the assignee, builds the deadline object, creates the todo, and echoes back title, participants, and deadline. ## Quick Start Ask the assistant to create a WeCom todo such as 'add a todo to submit the expense report by next Friday' and it will handle the rest through wecom-cli.

Frequently Asked Questions about wecomcli-todo

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

FAQPage Schema
How do I create a WeCom todo with a deadline and reminder?

Call wecom-cli todo create with a JSON body containing items, each with a title and an optional deadline object. Use type datetime with remind_at_deadline=true to remind at the exact deadline moment, or type date for date-only deadlines with default advance reminder.

How do I list or search my WeCom todos by status or keyword?

Use wecom-cli todo list with status_filter (finished or proceed), keywords arrays for OR/AND matching, and optional create or deadline time ranges. Note that omitting status_filter returns only in-progress todos, and use --page-count to fetch all pages.

Can I set a reminder X minutes before a WeCom todo deadline?

The API cannot directly set an advance reminder offset; deadline always stores the actual due time. After creating, check the returned extra_info, and if it does not match the requested advance time, the user must adjust the reminder manually in the WeCom todo app.

What happens when a non-creator deletes a WeCom todo?

The same delete interface works for non-creators, but the semantic is exiting the todo rather than deleting it for everyone. Only the creator's delete removes the entire todo for all participants, so the skill checks the creator field to phrase the result correctly.

Why does finishing a WeCom todo sometimes ask about finishing all?

When the current user is both creator and participant, the backend returns ask_finish_all after marking only their own part complete. The skill then asks the user to choose between finishing only their part or marking the entire todo finished with finished_all=true.