Feishu CLI (Lark CLI) is the official open-source command-line tool from the Lark Open Platform by ByteDance. Access 200+ commands across 11 business domains with 19 built-in AI Agent Skills — messaging, documents, spreadsheets, calendar, email, tasks, meetings, and beyond.
Feishu CLI bridges the gap between AI Agents and enterprise productivity. Every command is tested with real agents, designed with concise parameters, smart defaults, and structured output formats to maximize automation success rates.
Built from the ground up for AI Agents like Claude Code, Cursor, Codex, and OpenCode. 19 structured Skills enable natural language control over the entire Lark platform without writing any code.
Shortcuts for quick actions, API commands for precise control, and raw API access for the full 2,500+ endpoint surface. Choose the right abstraction level for each task.
Output in JSON, NDJSON, table, CSV, or pretty-print format. Built-in pagination with --page-all, configurable page limits, and binary file output support.
OS-native keychain credential storage, input injection protection, terminal output sanitization, and --dry-run previews for all destructive operations.
OAuth 2.0 Device Flow with user and bot identity switching. Scope-based permissions with --recommend for least-privilege access. Interactive TUI and headless Agent mode.
Runs on macOS, Linux, and Windows across x64 and arm64 architectures. Built in Go, distributed via npm with automatic platform-specific binary installation.
Feishu CLI organizes its commands into three progressive layers, allowing humans and AI Agents to operate at the right abstraction level.
Human and AI-friendly commands prefixed with +. Smart defaults, table output, and dry-run previews built in.
lark-cli calendar +agenda lark-cli im +messages-send --text "Hello"
100+ curated commands auto-generated from Lark OAPI metadata. 1:1 mapping to platform endpoints for precise control.
lark-cli calendar events instance_view --params '{...}'
Direct HTTP calls to any of 2,500+ Lark Open Platform API endpoints. Full flexibility when shortcuts and API commands don't cover your needs.
lark-cli api GET /open-apis/calendar/v4/calendars
Feishu CLI (Lark CLI) provides comprehensive coverage across all major Lark platform capabilities, from daily messaging to complex multi-dimensional table operations.
10 shortcuts — send, reply, search, group management
7 shortcuts — create, read, update with Markdown
60 shortcuts — tables, records, fields, views, dashboards
4 shortcuts — agenda, events, free/busy, time suggestions
11 shortcuts — send, reply, forward, triage, watch
11 shortcuts — create, assign, complete, reminders
3 shortcuts — upload, download, comments
7 shortcuts — read, write, append, find, export
Knowledge spaces and document nodes
2 shortcuts — search records, query minutes
2 shortcuts — search users, get profiles
Feishu CLI ships with 19 structured Skill definitions that integrate natively with Claude Code, Cursor, Codex, OpenCode, and other AI coding assistants. Each Skill teaches AI Agents exactly how to use the CLI for a specific domain.
| Skill | Category | Description |
|---|---|---|
lark-shared |
Core | Foundation skill auto-loaded by all others. App configuration, authentication, identity switching, scope management, and security rules. |
lark-im |
Messaging | Send and reply to messages, manage group chats, search message history, upload and download media, emoji reactions, and thread replies. |
lark-doc |
Docs | Create, read, update, and search cloud documents using Markdown syntax. Supports media insertion, download, and whiteboard operations. |
lark-base |
Data | Full CRUD for multi-dimensional tables, fields, records, and views. Data aggregation queries, dashboards, workflows, roles, and forms. |
lark-sheets |
Data | Create, read, write, append, find, and export spreadsheet data. Supports value rendering options and async file export. |
lark-calendar |
Productivity | Calendar event management including agenda view, event creation with attendees, free/busy queries, and optimal time suggestions. |
lark-mail |
Communication | Browse, search, read, send, reply, and forward emails. Draft management, attachments, folder labels, and real-time WebSocket mail monitoring. Includes anti-prompt-injection security rules. |
lark-task |
Productivity | Create, update, complete, and reopen tasks. Subtasks, task lists, member assignment, followers, comments, and configurable reminders. |
lark-drive |
Storage | Upload and download files, manage permissions, and add document comments with wiki URL resolution support. |
lark-contact |
Directory | Search users by name, email, or phone number. Retrieve detailed user profiles from the organization directory. |
lark-wiki |
Knowledge | Manage knowledge spaces and document nodes. Resolve wiki tokens to actual document tokens for cross-module operations. |
lark-event |
Platform | Real-time event subscriptions via WebSocket long connections. NDJSON output with regex routing and agent-friendly compact format. |
lark-vc |
Meetings | Search historical meeting records and query AI-generated meeting minutes, including summaries, to-dos, transcripts, and chapters. |
lark-whiteboard |
Visual | Render whiteboards and charts via DSL or Mermaid syntax. Supports architecture diagrams, flowcharts, org charts, bar and line charts, funnels, mind maps, and more. Outputs to PNG. |
lark-minutes |
Meetings | Retrieve meeting minutes metadata and AI artifacts including title, duration, AI-generated summary, action items, and chapter breakdown. |
lark-openapi-explorer |
Platform | API discovery tool that guides agents to explore Lark's official OpenAPI documentation layer by layer when existing skills don't cover a specific need. |
lark-skill-maker |
Platform | Custom skill creation framework. Provides templates and best practices for packaging CLI operations into reusable SKILL.md files. |
lark-workflow-meeting-summary |
Workflow | Orchestrated workflow that collects meeting notes over a time range and generates structured summary reports using vc +search and vc +notes. |
lark-workflow-standup-report |
Workflow | Orchestrated workflow that combines calendar agenda and task lists to generate a comprehensive daily standup or status report. |
Get up and running with Lark CLI in under five minutes. Requires Node.js 16 or later on macOS, Linux, or Windows.
Teams use Feishu CLI (Lark CLI) to automate workflows, streamline communication, and build AI-powered office assistants that operate across all Lark platform services.
Send customized messages to all team members in under a minute. AI agents compose unique content per recipient and dispatch through the IM module automatically.
Scan Bitable records for missing fields, data inconsistencies, and formatting issues. Automatically notify responsible team members to fix identified problems.
Extract action items from meeting minutes, create follow-up documents, assign tasks to team members, and send notification messages in one automated pipeline.
Query multiple team members' calendar availability across time zones and recommend optimal meeting times using the free/busy and suggestion APIs.
Aggregate monitoring data, news feeds, or internal reports and deliver structured daily briefings to designated Lark groups each morning.
Watch incoming mail for resume attachments, extract key information, organize candidates into structured Bitable records, and send acknowledgment emails.
Feishu CLI is built with proven, production-grade open-source technologies. Written in Go for performance and distributed via npm for accessibility.
Feishu CLI implements multiple layers of security protection to safeguard your data when used by both human operators and AI Agents.
Credentials are stored in macOS Keychain, Windows Credential Manager, or Linux Secret Service. Never saved in plain text.
All inputs are validated and sanitized to prevent command injection attacks and prompt injection in AI Agent contexts.
Use --dry-run on any write operation to preview the exact API request before execution. Essential for AI Agent safety.
The --recommend flag during login automatically selects only the minimum required permissions for common operations.
All terminal output is sanitized to prevent ANSI escape sequence injection and other terminal-based attacks.
The mail skill treats all email content as untrusted input, with specific rules to prevent prompt injection through email bodies.
Dive deeper into specific Feishu CLI capabilities with our detailed guides covering installation, AI integration, and each business domain.
Step-by-step instructions for installing Feishu CLI, configuring credentials, OAuth authentication, and troubleshooting with lark-cli doctor.
Complete guide to all 19 AI Agent Skills. Integrate with Claude Code, Cursor, and Codex for natural language office automation.
Send messages, manage group chats, search conversations, reply to threads, and download media with 10 IM shortcuts.
View agenda, create events, check free/busy status, and get AI-powered meeting time suggestions via the calendar module.
Create, read, and update cloud documents with Markdown. Insert media, manage whiteboards, and search across all content types.
60 shortcuts for tables, records, fields, views, dashboards, workflows, forms, and advanced permissions in Lark Bitable.
Compose, send, reply, forward emails. Manage drafts, triage inbox, and monitor incoming mail with WebSocket watch.
Create and assign tasks, set reminders, manage subtasks and task lists. Track progress and collaborate with your team.
Feishu CLI (also known as Lark CLI) is the official open-source command-line tool from the Lark Open Platform by ByteDance. It provides 200+ commands across 11 business domains including messaging, documents, calendar, email, tasks, and more. The CLI binary is named lark-cli and the npm package is @larksuite/cli. It is designed for both human developers and AI Agents, released under the MIT license.
Feishu and Lark are the same product by ByteDance. Feishu is the Chinese brand name, while Lark is the international brand. Feishu CLI and Lark CLI refer to the same tool — the lark-cli binary. It works with both Feishu (feishu.cn) and Lark (larksuite.com) platform accounts.
Yes. Feishu CLI ships with 19 AI Agent Skills that integrate natively with Claude Code, Cursor, Codex, OpenCode, and other AI coding assistants. After installing the Skills via npx skills add larksuite/cli -y -g, AI agents can operate the entire Lark platform through natural language commands. Remember to restart your AI tool after installation.
Feishu CLI runs on macOS, Linux, and Windows across both x64 and arm64 architectures. It requires Node.js 16 or later for npm installation. The CLI is built in Go and distributed as a platform-specific binary through npm.
Feishu CLI uses OAuth 2.0 Device Flow for authentication. During login, it provides a URL for browser-based authorization. Credentials are stored securely in your operating system's native keychain. The tool supports both user and bot identities, switchable with the --as flag.
Yes. Feishu CLI is open source under the MIT license with no usage fees. You need a Lark or Feishu account and a self-built application on the Lark Open Platform to generate the required App ID and App Secret credentials. The Lark Open Platform itself offers free tier access for most APIs.
Layer 1 (Shortcuts) provides human and AI-friendly commands prefixed with +, offering smart defaults and structured output. Layer 2 (API Commands) maps 1:1 to 100+ curated platform endpoints. Layer 3 (Raw API) enables direct HTTP calls to any of 2,500+ Lark Open Platform API endpoints via lark-cli api.