feishu-cli-storage

Manage Feishu Drive files, wiki spaces, comments, and document permissions via CLI.

1.4k|142|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-storage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feishu-cli-storage
Source: https://github.com/riba2534/feishu-cli/tree/main/skills/feishu-cli-storage
Command: npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-storage

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Managing Feishu cloud storage—uploading large files, organizing wiki knowledge bases, handling document comments, and configuring collaborator permissions—normally requires navigating multiple web interfaces and APIs. This Skill unifies all of these operations into scriptable feishu-cli commands that an AI agent can execute directly.

Core Features & Use Cases

  • Drive file operations: Upload and download files with automatic chunked transfer for files over 20MB, async import/export with resumable tasks, and local-to-cloud directory mirroring with SHA-256 verification.
  • Wiki knowledge base management: Create, move, copy, and recursively export wiki node trees, manage spaces and members, with safeguards like mandatory --yes confirmation for space deletion.
  • Comments and permissions: List, add, resolve, and reply to document comments; add/update/remove collaborators, manage public sharing settings and passwords, and transfer document ownership.
  • Use Case: Back up an entire wiki subtree to a local folder with wiki export-tree, then grant a teammate edit access to the exported source documents using perm add with the correct doc-type mapping.

Quick Start

Ask the AI to upload a local file to a Feishu Drive folder or list the collaborators of a document using this skill.

Frequently Asked Questions about feishu-cli-storage

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

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

Use feishu-cli drive upload with the --file and --folder-token flags. Files over 20MB automatically use three-phase chunked upload (prepare/part/finish) with per-chunk retries. This command requires a User Token and the drive:file:upload scope.

How do I add collaborator permissions to a Feishu document?

Run feishu-cli perm add with the document token, --doc-type, --member-type, --member-id, and --perm flags. Match the doc-type to the token prefix, for example doxcn maps to docx and shtcn maps to sheet. Permission commands use App Token identity.

Can I use a Drive file_token as a message file_key in Feishu?

No, Drive file_token and IM file_key are not interchangeable. To send a file to a chat, use the messaging command's --file flag directly, or share the Drive file link instead of trying to reuse the token.

How do I back up an entire Feishu wiki knowledge base?

Use feishu-cli wiki export-tree with the node token and --output-dir to recursively export the whole subtree. Wiki nodes use node tokens (wikcn prefix), which are different from ordinary document tokens and must not be mixed.

Why does feishu-cli file delete not remove the file in a script?

file delete prompts for interactive confirmation by default, and in non-interactive environments it cancels silently with exit code 0. Always pass --force in scripts or agent pipelines to ensure the deletion actually executes.

Can I delete an entire comment thread on a Feishu document?

Feishu does not support deleting a whole comment directly. You can delete individual replies with comment reply delete, or mark the comment as resolved using comment resolve to close the discussion.