feishu-cli-toolkit

Feishu Lightweight Toolbox

This skill is a fallback and does not compete with specialized skills for responsibilities. Triage first, then execute the corresponding command.

Token Strategy (only within the scope covered by this skill)

Type	Behavior
Read-type + sheet full suite (all sheet read/write commands, calendar list/get/event-search/freebusy/attendee list, task get/list/comment list/subtask list/tasklist get/list/tasks, file meta/stats/list/version list/get, download, wiki nodes/spaces, etc.)	Already `auth login` automatically uses User Token, falls back to App Token when not logged in (`resolveOptionalUserTokenWithFallback`）
Write-type (calendar create-event/update/delete/event-reply/attendee add, task create/update/delete/comment add/reminder add/..., tasklist create/delete/add-task/remove-task, wiki member add/remove)	Defaults to App Token (Bot identity), only when explicitly `--user-access-token` switches to User (`resolveOptionalUserToken`）
User Token required (approval task query/approve/reject/transfer + instance get/cancel/cc, my_tasks, calendar rsvp)	Errors directly when not logged in (`resolveRequiredUserToken` / `requireUserToken`）

For complete cross-skill rules (including commands outside this skill's scope such as search / chat / msg flag), see feishu-cli-auth skill's "Token Resolution Strategy" section.

Triage

User Intent	Skill to Use
Read documents / export Markdown	`feishu-cli-read` / `feishu-cli-export`
Create, edit, import Markdown	`feishu-cli-write` / `feishu-cli-import`
Large file upload, cloud drive asynchronous import/export, rich text comments, drive search	`feishu-cli-drive`
Multi-dimensional table base/v3	`feishu-cli-bitable`
Whiteboard, Mermaid/PlantUML directly to board, SVG pipeline	`feishu-cli-board`
Send messages, cards, group chat history	`feishu-cli-msg` / `feishu-cli-card` / `feishu-cli-chat`
Email, meetings/Minutes, search, permissions, authentication	Corresponding `mail` / `vc` / `search` / `perm` / `auth` skill

Module Quick Reference

Module	Common Commands	Detailed Reference
Spreadsheet Sheet	`sheet create/get/read/write/append/import-md/export`, V3 rich text	`references/sheet-commands.md`
Calendar Schedule	`calendar list/get/primary/create-event/list-events/get-event/update-event/delete-event/event-search/freebusy`	`references/calendar-commands.md`
Tasks / Lists	`task create/complete/delete`、`task subtask/member/reminder/comment`、`tasklist`	`references/task-commands.md`
Basic group creation	`chat create/link`	`references/chat-commands.md`
Basic files	`file list/mkdir/move/copy/delete/download/upload/version/meta/stats`	This file
Assets	`media upload/download`	This file
Comments	`comment list/add/delete/resolve/unresolve`、`comment reply`	This file
Knowledge Base	`wiki get/update/export/spaces/nodes/space-get/member`	This file
Approval	`approval get`、`approval task query`(User Token required)	This file
Users/Departments	`user info/search/list`、`dept get/children`	This file

Sheet

Ordinary spreadsheet read/write and Markdown table import/export:

feishu-cli sheet create --title "数据表"
feishu-cli sheet read <token> "A1:C10" --sheet-id <sheet_id>
feishu-cli sheet write <token> "A1:B2" --sheet-id <sheet_id> --data '[["姓名","分数"],["张三",95]]'
feishu-cli sheet import-md report.md --title "报表"
feishu-cli sheet export <token_or_url> --format markdown -o report.md

For details such as rich text, styles, images, and protected ranges, see references/sheet-commands.md. Note that sheet export supports /sheets/<token> URL。

Calendar

feishu-cli calendar list
feishu-cli calendar primary
feishu-cli calendar create-event --calendar-id <id> --summary "会议" \
  --start "2024-01-21T14:00:00+08:00" --end "2024-01-21T15:00:00+08:00"
feishu-cli calendar list-events <calendar_id> --start-time "2024-01-01T00:00:00+08:00"
feishu-cli calendar get-event <calendar_id> <event_id>
feishu-cli calendar update-event <calendar_id> <event_id> --summary "新标题"
feishu-cli calendar delete-event <calendar_id> <event_id>
feishu-cli calendar event-search --calendar-id <id> --query "周会"

For more parameters, see references/calendar-commands.md。

Task / Tasklist

feishu-cli task create --summary "任务标题"
feishu-cli task complete <task_guid>
feishu-cli task subtask create <task_guid> --summary "子任务"
feishu-cli task member add <task_guid> --members ou_xxx --role assignee
feishu-cli tasklist create --name "项目清单"
feishu-cli tasklist tasks <tasklist_guid>

For complete task, member, reminder, and comment commands, see references/task-commands.md。

File / Media

Basic file and asset commands are suitable for simple App Token scenarios; for upload resume and cloud drive diff, use feishu-cli-drive。

feishu-cli file list <folder_token>
feishu-cli file upload ./report.pdf --parent fldxxx
feishu-cli file download <file_token> -o ./report.pdf
feishu-cli file download <file_token> -o large.zip --timeout 30m       # 大文件可调超时
feishu-cli file mkdir "新文件夹" --parent fldxxx
feishu-cli media upload image.png --parent-type docx_image --parent-node <document_id>
feishu-cli media download <file_token> -o ./image.png

file download Automatically uses User Token when logged in (resolveOptionalUserTokenWithFallback, or you can explicitly --user-access-token). User-identity downloads go over raw HTTP, and when hitting Feishu's large-file limit (100MB+), they automatically use HTTP Range chunked download and merge—consistent with drive download , so the toolkit can handle user-mode large files without having to go around feishu-cli-drive。

Comment / Wiki

feishu-cli comment list <file_token> --type docx
feishu-cli comment add <file_token> --type docx --text "评论内容"
feishu-cli comment resolve <file_token> <comment_id> --type docx

feishu-cli wiki spaces
feishu-cli wiki nodes <space_id>
feishu-cli wiki get <node_token>
feishu-cli wiki update <node_token> --title "新标题"              # 改节点标题（仅 doc/docx/快捷方式；需 wiki:node:update）
feishu-cli wiki space-get <space_id>                              # 知识库基础信息（名称/类型/可见性/分享状态）
feishu-cli wiki member list <space_id>

# 高危：删除整个知识库（需 --yes 才会真删，缺 --yes 直接拒绝）
feishu-cli wiki delete-space <space_id> --yes                     # 自动轮询异步任务直至完成 / 超时

# v1.29+ 新增 ⭐
feishu-cli wiki space-create --name "新知识库" [--description "..."]      # 创建知识库
feishu-cli wiki space-list [--page-all] [--page-limit N] [-o json]         # 列出所有可见 space（默认仅第一页）
feishu-cli wiki node-copy --space-id <src> --node-token <node> \
  --target-space-id <dst> [--title "副本标题"]                              # 复制节点（也可用 --target-parent-node-token）

Comment pitfalls

Reports 1069302/1069303 forbidden = the current token cannot see this document's comments.
- Personal cloud documents (owner is user) must use User Token:feishu-cli comment list <token> --type docx --user-access-token "u-xxxxx" or first feishu-cli auth login
- App cloud documents (owner is App) can use tenant token, but the App must be a collaborator
- Documents in external groups may return 232033 (see feishu-cli-chat/references/external-chat.md）
--user-access-token is the comment subcommand'sglobal flag(supported by list/add/get/reply/resolve/unresolve), and once passed, all comment operations use the user identity.

Use when you need rich-text comments, automatic wiki URL parsing, or local comments feishu-cli-drive。

Approval / User / Dept

feishu-cli approval get <approval_code>
feishu-cli approval task query --topic todo -o json

feishu-cli user info ou_xxx
feishu-cli user search --email user@example.com
feishu-cli user list --department-id od_xxx
feishu-cli dept get <department_id>
feishu-cli dept children <department_id>

approval task query requires User Token; before executing, you can use feishu-cli-auth for scope pre-check.

Pre-execution check

If unsure about the module, first look at the triage table above.
For commands involving User Token, first run feishu-cli auth check --scope "<scope>"。
When complex parameters are needed, read the corresponding references/*.md, and do not treat secondary references as default context.