lark-drive

Manage Lark Drive files and folders including upload, download, import, export, comments, and permissions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Managing files and folders in Lark (Feishu) cloud storage through manual UI clicks is slow and hard to automate. This Skill lets you search, upload, download, organize, import, export, comment on, and control permissions for Drive resources directly through the lark-cli command line. ## Core Features & Use Cases - File & Folder Operations: Upload, download, create folders, move, copy, delete, rename titles, and create shortcuts across your Drive, with token/URL routing for docx, sheet, bitable, slides, wiki, and file resources. - Import & Export: Convert local Word, Markdown, Excel, CSV, PPTX, and .base files into online docx/sheet/bitable/slides documents, and export online documents back to PDF, XLSX, CSV, Markdown, or PPTX. - Comments, Versions & Permissions: Add full-text or anchored comments, query comment locations, manage file version history, apply for document access, and manage collaborator permissions. - Use Case: You receive a doubao.com or feishu.cn wiki link and need to download the underlying spreadsheet, add review comments to specific cells, and then move it into an archive folder — this Skill resolves the wiki token, routes each action to the right command, and executes them in sequence. ## Quick Start Use the lark-drive skill to search my Lark cloud drive for documents I edited in the last week and download the most recent one.

Frequently Asked Questions about lark-drive

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

FAQPage Schema
How do I upload a file to Lark Drive from the command line?

Use lark-cli drive +upload with the local file path and a target folder token, or pass --wiki-token to upload under a wiki node. For whole directories, use drive +push to mirror a local folder into a Drive folder.

How do I import an Excel or CSV file into a Lark Base (bitable)?

Run lark-cli drive +import --file ./data.xlsx --type bitable. The import step always goes through Drive, not lark-base; only after the import finishes and returns the new document token do you switch to lark-base for table, field, and record operations.

Can I use a wiki URL directly for Drive operations?

Not directly for most operations. A /wiki/ token is a node token, not the underlying file token, so first run lark-cli drive +inspect --url <wiki_url> to unwrap it and get the real obj_token and type before commenting, downloading, or exporting.

Why does drive +import or +delete return ready=false with a ticket?

Import, export, folder move, and folder delete are asynchronous tasks. When the built-in polling window expires, the command returns a ticket or task_id plus a next_command; continue polling with lark-cli drive +task_result using that ticket until the task completes.

What are the limitations of adding comments to Drive files?

Plain Drive files only support full-text comments and only for whitelisted extensions like .md, .txt, .csv, .py, .png, and .mp4; .pdf, .docx, and .xlsx files are rejected. Anchored (partial) comments require docx, sheet, or slides targets with a block ID.

When should I use lark-drive versus lark-doc or lark-sheets?

Use lark-drive for storage-level operations: upload, download, move, delete, import, export, search, comments, and permissions. Use lark-doc for document content editing, lark-sheets for spreadsheet cells, lark-base for bitable records, and lark-markdown for native .md file patching.