wecomcli-disk

Manage WeCom Drive files via wecom-cli: list, search, upload, download, rename, and create folders.

2.0k|291|Updated Jul 24, 2026
One-click install
npx skills add https://github.com/Pinvou/pinvou-agent --skill wecomcli-disk-pinvou
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wecomcli-disk
Source: https://github.com/Pinvou/pinvou-agent/tree/main/pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-disk
Command: npx skills add https://github.com/Pinvou/pinvou-agent --skill wecomcli-disk-pinvou

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires wecom-cli.

What problem does it solve? It lets an AI agent operate on WeCom (Enterprise WeChat) Drive files directly from the command line, so users can find, inspect, upload, download, and organize cloud drive content without opening the WeCom client. ## Core Features & Use Cases - File discovery: List recently viewed files and search the drive by keywords, file type, creator, or shared space, with pagination and sorting. - File transfer: Upload local files or media assets to a target folder and download offline binary files (Word, Excel, PDF, images) to a local path. - Organization: Rename files and create new folders inside personal or shared spaces. - Use Case: A user asks "find my Q3 report Excel in the sales shared space and download it" — the skill searches with type filters, resolves the file ID, and downloads it to a local path for further processing. ## Quick Start Ask the agent to search my WeCom Drive for the quarterly report spreadsheet and download it to my local machine.

Frequently Asked Questions about wecomcli-disk

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

FAQPage Schema
How do I search files in WeCom Drive from the command line?

Run wecom-cli disk files search with a JSON payload containing keywords, creator_userids, search_type, or file_types — at least one of the four is required. Results are paginated via cursor and can be sorted by modify_time or file_size.

How do I upload a local file to WeCom Drive?

Use wecom-cli disk files upload with either file_path (a real local absolute path) or file_content_media (an existing media_id starting with mc) — the two are mutually exclusive. Optionally pass folder_id to target a specific folder or shared space.

Can I download online WeCom documents like sheets or smartpages?

No. Online document types (word, sheet, smartsheet, smartpage, ppt, collect, mind, flow, journal) cannot be downloaded through the disk API. Read their content via the corresponding wecomcli-doc, wecomcli-sheet, wecomcli-smartsheet, or wecomcli-smartpage skills using the returned docid.

What file operations are not supported by this skill?

Moving, deleting, or copying files, renaming or deleting folders, managing shared spaces and permissions, share links, version history, and content parsing are not supported. Users are directed to perform these manually in the WeCom client.

Why does my WeCom Drive search return no results?

Searches require at least one of keywords, creator_userids, search_type, or file_types; space_keywords alone cannot trigger a search. If two to three adjusted attempts still return nothing, the file likely does not exist or is inaccessible, and the user should refine keywords or filters.