lark-drive

Manage Lark Drive files, folders, comments, permissions, and document imports via lark-cli.

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/sliec/shared-files --skill lark-drive-sliec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-drive
Source: https://github.com/sliec/shared-files/tree/main/skills/lark-drive
Command: npx skills add https://github.com/sliec/shared-files --skill lark-drive-sliec

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Working with Lark (Feishu) cloud storage from an agent or terminal requires juggling many APIs: uploading and downloading files, organizing folders, importing local Word/Excel/PPTX files as online documents, managing comments and permissions, and resolving wiki links to real document tokens. This Skill wraps all of that into a consistent set of lark-cli drive commands and shortcuts. ## Core Features & Use Cases - File and folder management: Upload, download, copy, move, delete, rename files, create folders, and inspect document URLs (including automatic wiki URL unwrapping to the underlying docx/sheet/bitable token). - Import and export: Convert local .docx/.md/.xlsx/.csv/.pptx/.base files into Lark online documents (docx, sheet, bitable, slides), and export cloud documents back to PDF, XLSX, Markdown, PPTX, and more. - Comments, permissions, and sync: Add full-text or anchored (block/cell/slide-element) comments, list and reply to comments, manage collaborator permissions and secure labels, and run one-way or two-way sync between a local directory and a Drive folder with +pull/+push/+sync. - Use Case: A user says "import this Excel file as a Base and put it in my Reports folder" — the Skill runs lark-cli drive +import --type bitable --folder-token <token>, polls the task, and returns the new document URL. ## Quick Start Ask the agent to upload a local file to your Lark Drive or import a local document as an online doc, for example: "Import report.docx from my current folder into Lark as a cloud document."

Frequently Asked Questions about lark-drive

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

FAQPage Schema
How do I import a local Excel or CSV file into Lark Base?

Run lark-cli drive +import --file ./data.xlsx --type bitable. The command uploads the file, creates an import task, and polls until the new bitable document is ready. Use --folder-token to place it in a specific folder or --target-token to append data to an existing Base.

How do I download or upload files to Lark Drive from the command line?

Use lark-cli drive +download --file-token <token> to fetch a file, and lark-cli drive +upload to push a local file into a folder or wiki node. For whole directories, +pull and +push mirror files between a local folder and Drive.

Can I use a Lark wiki URL directly for document operations?

Not directly — a wiki token is not a file token. Run lark-cli drive +inspect --url <wiki_url> to unwrap it to the underlying docx, sheet, or bitable token, or call wiki spaces get_node to get obj_type and obj_token before operating.

What file types can be imported as Lark online documents?

Word (.docx/.doc), text, Markdown, and HTML import as docx; .xlsx/.xls/.csv import as sheet or bitable; .base snapshots import as bitable; .pptx imports as slides. Each extension has size limits, for example 20MB for .base and 500MB for .pptx.

Why does adding a comment to a Drive file fail?

Drive file comments only support whitelisted extensions such as .md, .txt, .csv, .py, .png, and .mp4, and only full-text comments — anchored comments are unsupported for plain files. Formats like .pdf, .docx, and .xlsx as raw files are rejected by the CLI.

How do I sync a local folder with a Lark Drive folder?

Use lark-cli drive +sync for two-way sync, or +pull/+push for one-way mirroring with --if-exists smart for incremental runs. Destructive options like --delete-local or --delete-remote require an explicit --yes flag.