Feishu Cli Bitable
Operate Feishu Bitable (Base) bases from the terminal—tables, views, records, roles, dashboards, forms, and workflows—for indie teams on Lark.
Overview
feishu-cli-bitable is an agent skill most often used in Build (also Operate iterate) that exposes Feishu Base v3 table, record, view, dashboard, form, and workflow operations via feishu-cli.
Install
npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-bitableWhat is this skill?
- Full base/v3 Bitable coverage: create/copy bases, tables, fields, views with sort/filter/group, record upsert and attach
- Dashboard, form, workflow, role CRUD, advanced permissions, and data aggregation queries
- User Access Token required for all commands via feishu-cli auth login; App ID/Secret injected for v3 headers
- --base-token from /base/<token> URLs; legacy --app-token alias removed
- Documented Bash tool scope: feishu-cli bitable:* and feishu-cli auth:* plus Read/Write for agent workflows
- Documents base/v3 migration from legacy bitable/v1 with unified --base-token
- Skill frontmatter allows Bash(feishu-cli bitable:*) and Bash(feishu-cli auth:*) tool patterns
Adoption & trust: 533 installs on skills.sh; 1.2k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You run PM or ops on Feishu Bitable but lack scriptable, agent-friendly commands to create bases, mutate records, and configure views without manual UI work.
Who is it for?
Indie and small teams standardized on Feishu/Lark who already use feishu-cli and need repeatable Base automation from Claude Code or similar agents.
Skip if: Builders outside the Feishu ecosystem, or users who only need occasional one-click edits without CLI auth setup.
When should I use this skill?
User requests creating or operating Feishu Bitable/Base—tables, records, views, roles, dashboards, forms, workflows, attachments, or copy base—in Chinese or English trigger phrases listed in the skill.
What do I get? / Deliverables
Your agent executes documented feishu-cli bitable commands against the correct base token with authenticated user access, keeping bases and workflows in sync with your repo or runbooks.
- Created or updated Bitable bases, tables, fields, and views
- Upserted records with optional attachments and aggregation query results
- Configured dashboards, forms, workflows, or role and permission settings
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Build/integrations is the canonical shelf because the skill is a base/v3 CLI surface for wiring product and ops data into Feishu, with ongoing use in Operate. Integrations subphase fits third-party SaaS automation (CRM, PM, approvals) rather than in-app frontend code.
Where it fits
Create a sales base with filtered views and upsert leads from a deployment script.
Pull record change history and adjust roles when onboarding a contractor.
Spin up a blank copy of a template base to model pricing experiments without touching production data.
Update a customer lifecycle table and dashboard blocks after a campaign segment change.
How it compares
A Feishu-specific integration skill—not a generic spreadsheet MCP; pairs with feishu-cli auth rather than raw REST from scratch.
Common Questions / FAQ
Who is feishu-cli-bitable for?
Solo builders and small teams on Feishu who want terminal and agent-driven control of Bitable bases, records, and workflows.
When should I use feishu-cli-bitable?
Use it in Build/integrations when wiring data sync and in Operate/iterate when updating production trackers; also during Validate/scope when standing up a lightweight CRM or pipeline base.
Is feishu-cli-bitable safe to install?
It can read and write live Feishu data with user tokens; review the Security Audits panel on this page, scope app permissions minimally, and avoid running destructive commands on production bases without backups.
SKILL.md
READMESKILL.md - Feishu Cli Bitable
# 飞书多维表格（Bitable / Base） 通过 **base/v3 API** 操作飞书多维表格。`bitable` 也支持 `base` 别名。 > **API 切换**：此技能已从旧的 `bitable/v1` 切换到新的 `base/v3`。字段名 `app_token` 和 `base_token` 在飞书文档里是同一个值的两种叫法（老 v1 叫 app_token，新 v3 叫 base_token），CLI 只认 **`--base-token`**（`--app-token` 已删除）。从多维表格 URL 里 `/base/<token>` 或 `/bitable/<token>` 片段里取 token 即可。 ## 前置条件 - **认证**：所有命令**必需 User Access Token**（读类、写类均强制要求 User Token，未登录直接报错）。先执行 `feishu-cli auth login` 登录 - **App 凭证**：应用 App ID + App Secret（base/v3 需要 `X-App-Id` header，自动注入） ## 命令速查 ### 基础（3 命令） ```bash # 创建多维表格 feishu-cli bitable create --name "项目管理" --time-zone Asia/Shanghai feishu-cli bitable create --name "销售" --folder-token fldxxx # 获取多维表格信息 feishu-cli bitable get --base-token bscnxxxx # 复制多维表格 feishu-cli bitable copy --base-token bscnxxxx --name "副本" feishu-cli bitable copy --base-token bscnxxxx --name "空白副本" --without-content ``` ### 数据表 table（5 命令） ```bash feishu-cli bitable table list --base-token bscnxxxx feishu-cli bitable table get --base-token bscnxxxx --table-id tblxxx feishu-cli bitable table create --base-token bscnxxxx --name "任务表" feishu-cli bitable table create --base-token bscnxxxx --config-file table.json feishu-cli bitable table update --base-token bscnxxxx --table-id tblxxx --name "新名字" feishu-cli bitable table delete --base-token bscnxxxx --table-id tblxxx ``` ### 字段 field（6 命令） ```bash feishu-cli bitable field list --base-token xxx --table-id tblxxx feishu-cli bitable field get --base-token xxx --table-id tblxxx --field-id fldxxx feishu-cli bitable field create --base-token xxx --table-id tblxxx --config-file field.json feishu-cli bitable field update --base-token xxx --table-id tblxxx --field-id fldxxx --config '...' feishu-cli bitable field delete --base-token xxx --table-id tblxxx --field-id fldxxx feishu-cli bitable field search-options --base-token xxx --table-id tblxxx --field-id fldxxx --query "关键词" ``` ### 记录 record（14 命令） ```bash feishu-cli bitable record list --base-token xxx --table-id tblxxx --view-id viewxxx --limit 100 feishu-cli bitable record get --base-token xxx --table-id tblxxx --record-id recxxx feishu-cli bitable record batch-get --base-token xxx --table-id tblxxx --record-ids recxxx,recyyy feishu-cli bitable record search --base-token xxx --table-id tblxxx --config-file search.json # upsert：不传 --record-id 则 POST 创建；传 --record-id 则 PATCH 更新（官方无专用 upsert 端点） feishu-cli bitable record upsert --base-token xxx --table-id tblxxx --config '{"fields":{"名称":"测试"}}' feishu-cli bitable record upsert --base-token xxx --table-id tblxxx --record-id recxxx --config '{"fields":{"状态":"完成"}}' feishu-cli bitable record batch-create --base-token xxx --table-id tblxxx --config-file records.json feishu-cli bitable record batch-update --base-token xxx --table-id tblxxx --config-file records.json feishu-cli bitable record delete --base-token xxx --table-id tblxxx --record-id recxxx # batch-delete：POST /records/batch_delete，单次最多 500 条；--record-ids CSV 或 --from-file 任选其一 feishu-cli bitable record batch-delete --base-token xxx --table-id tblxxx --record-ids rec_1,rec_2,rec_3 feishu-cli bitable record batch-delete --base-token xxx --table-id tblxxx --from-file ids.txt # 每行一个 record_id # share-link：批量生成记录共享链接（v1.29+ 新增），单次最多 100 条 feishu-cli bitable record share-link --base-token xxx --table-id tblxxx --record-ids rec_1,rec_2