larksuite/cliPublic

The official Lark/飞书 CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, Meetings, and more, with 200+ commands and 20+ AI Agent Skills.

AI summary: The official CLI tool for Lark/Feishu, featuring over 200 commands and 20+ AI Agent Skills.

Stars
18.2K
+46 today
Forks
1.4K
Watchers
54
Open issues
305
Open PRs
429
Contributors
~169
Commits
1.2K
Branches
320

GoMITCreated Mar 25, 2026Last push 1d agoLatest release v1.0.100+101 stars this week+404 this month

Quick answers

What is cli?
The official CLI tool for Lark/Feishu, featuring over 200 commands and 20+ AI Agent Skills.
What does cli do?
The Lark CLI is the official command-line interface developed by the larksuite team to interact with the Lark/Feishu ecosystem. It is uniquely designed to be used by both human operators and autonomous AI Agents, bridging the gap between terminal workflows and Lark's core business domains. The tool provides over 200 distinct commands covering Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, and Meetings. Additionally, it specifically exposes more than 20 formatted 'AI Agent Skills' to easily integrate Lark capabilities directly into custom AI pipelines. It delivers fast, reliable execution across all major operating systems.
Who is cli for?
Developers, system administrators, and AI engineers who heavily utilize Lark or Feishu in their organizations. Users need to be highly comfortable with terminal environments and API authentication concepts.
How do I get started with cli?
npx @larksuite/cli@latest install
How popular is cli on GitHub?
larksuite/cli has 18,162 stars and 1,375 forks on GitHub, and gained 101 stars in the last 7 days.
What license does cli use?
larksuite/cli is released under the MIT license.

Star history

since Jul 29, 2026
05K10K15KJul 2026Sep 2026Oct 2026Nov 2026
18.2K stars as of Nov 19, 2026. Measured daily since Jul 29, 2026; GitHub no longer exposes earlier star timestamps.

Update history

4 recorded
  • Nov 15, 2026New release v1.0.100 (previously v1.0.99).
  • Nov 4, 2026New release v1.0.99 (previously v1.0.98).
  • Oct 15, 2026New release v1.0.98 (previously v1.0.97).
  • Oct 5, 2026New release v1.0.97 (previously v1.0.96).

Contribution activity

commits per day, last 52 weeks
NovDecJanFebMarAprMayJunJulAugSepOctNovMonWedFri2025-11-23: 0 commits2025-11-24: 0 commits2025-11-25: 0 commits2025-11-26: 0 commits2025-11-27: 0 commits2025-11-28: 0 commits2025-11-29: 0 commits2025-11-30: 0 commits2025-12-01: 0 commits2025-12-02: 0 commits2025-12-03: 0 commits2025-12-04: 0 commits2025-12-05: 0 commits2025-12-06: 0 commits2025-12-07: 0 commits2025-12-08: 0 commits2025-12-09: 0 commits2025-12-10: 0 commits2025-12-11: 0 commits2025-12-12: 0 commits2025-12-13: 0 commits2025-12-14: 0 commits2025-12-15: 0 commits2025-12-16: 0 commits2025-12-17: 0 commits2025-12-18: 0 commits2025-12-19: 0 commits2025-12-20: 0 commits2025-12-21: 0 commits2025-12-22: 0 commits2025-12-23: 0 commits2025-12-24: 0 commits2025-12-25: 0 commits2025-12-26: 0 commits2025-12-27: 0 commits2025-12-28: 0 commits2025-12-29: 0 commits2025-12-30: 0 commits2025-12-31: 0 commits2026-01-01: 0 commits2026-01-02: 0 commits2026-01-03: 0 commits2026-01-04: 0 commits2026-01-05: 0 commits2026-01-06: 0 commits2026-01-07: 0 commits2026-01-08: 0 commits2026-01-09: 0 commits2026-01-10: 0 commits2026-01-11: 0 commits2026-01-12: 0 commits2026-01-13: 0 commits2026-01-14: 0 commits2026-01-15: 0 commits2026-01-16: 0 commits2026-01-17: 0 commits2026-01-18: 0 commits2026-01-19: 0 commits2026-01-20: 0 commits2026-01-21: 0 commits2026-01-22: 0 commits2026-01-23: 0 commits2026-01-24: 0 commits2026-01-25: 0 commits2026-01-26: 0 commits2026-01-27: 0 commits2026-01-28: 0 commits2026-01-29: 0 commits2026-01-30: 0 commits2026-01-31: 0 commits2026-02-01: 0 commits2026-02-02: 0 commits2026-02-03: 0 commits2026-02-04: 0 commits2026-02-05: 0 commits2026-02-06: 0 commits2026-02-07: 0 commits2026-02-08: 0 commits2026-02-09: 0 commits2026-02-10: 0 commits2026-02-11: 0 commits2026-02-12: 0 commits2026-02-13: 0 commits2026-02-14: 0 commits2026-02-15: 0 commits2026-02-16: 0 commits2026-02-17: 0 commits2026-02-18: 0 commits2026-02-19: 0 commits2026-02-20: 0 commits2026-02-21: 0 commits2026-02-22: 0 commits2026-02-23: 0 commits2026-02-24: 0 commits2026-02-25: 0 commits2026-02-26: 0 commits2026-02-27: 0 commits2026-02-28: 0 commits2026-03-01: 0 commits2026-03-02: 0 commits2026-03-03: 0 commits2026-03-04: 0 commits2026-03-05: 0 commits2026-03-06: 0 commits2026-03-07: 0 commits2026-03-08: 0 commits2026-03-09: 0 commits2026-03-10: 0 commits2026-03-11: 0 commits2026-03-12: 0 commits2026-03-13: 0 commits2026-03-14: 0 commits2026-03-15: 0 commits2026-03-16: 0 commits2026-03-17: 0 commits2026-03-18: 0 commits2026-03-19: 0 commits2026-03-20: 0 commits2026-03-21: 0 commits2026-03-22: 0 commits2026-03-23: 0 commits2026-03-24: 0 commits2026-03-25: 0 commits2026-03-26: 0 commits2026-03-27: 0 commits2026-03-28: 7 commits2026-03-29: 0 commits2026-03-30: 6 commits2026-03-31: 11 commits2026-04-01: 11 commits2026-04-02: 17 commits2026-04-03: 10 commits2026-04-04: 0 commits2026-04-05: 0 commits2026-04-06: 0 commits2026-04-07: 18 commits2026-04-08: 23 commits2026-04-09: 18 commits2026-04-10: 23 commits2026-04-11: 11 commits2026-04-12: 2 commits2026-04-13: 13 commits2026-04-14: 7 commits2026-04-15: 10 commits2026-04-16: 10 commits2026-04-17: 16 commits2026-04-18: 5 commits2026-04-19: 0 commits2026-04-20: 9 commits2026-04-21: 9 commits2026-04-22: 15 commits2026-04-23: 14 commits2026-04-24: 6 commits2026-04-25: 5 commits2026-04-26: 0 commits2026-04-27: 7 commits2026-04-28: 16 commits2026-04-29: 12 commits2026-04-30: 12 commits2026-05-01: 1 commit2026-05-02: 0 commits2026-05-03: 0 commits2026-05-04: 0 commits2026-05-05: 0 commits2026-05-06: 9 commits2026-05-07: 6 commits2026-05-08: 6 commits2026-05-09: 3 commits2026-05-10: 0 commits2026-05-11: 10 commits2026-05-12: 6 commits2026-05-13: 6 commits2026-05-14: 14 commits2026-05-15: 8 commits2026-05-16: 0 commits2026-05-17: 0 commits2026-05-18: 13 commits2026-05-19: 16 commits2026-05-20: 13 commits2026-05-21: 10 commits2026-05-22: 9 commits2026-05-23: 0 commits2026-05-24: 1 commit2026-05-25: 13 commits2026-05-26: 16 commits2026-05-27: 9 commits2026-05-28: 11 commits2026-05-29: 7 commits2026-05-30: 3 commits2026-05-31: 0 commits2026-06-01: 3 commits2026-06-02: 14 commits2026-06-03: 13 commits2026-06-04: 8 commits2026-06-05: 13 commits2026-06-06: 3 commits2026-06-07: 1 commit2026-06-08: 15 commits2026-06-09: 12 commits2026-06-10: 13 commits2026-06-11: 13 commits2026-06-12: 14 commits2026-06-13: 5 commits2026-06-14: 0 commits2026-06-15: 9 commits2026-06-16: 7 commits2026-06-17: 6 commits2026-06-18: 5 commits2026-06-19: 0 commits2026-06-20: 0 commits2026-06-21: 0 commits2026-06-22: 2 commits2026-06-23: 9 commits2026-06-24: 7 commits2026-06-25: 10 commits2026-06-26: 5 commits2026-06-27: 1 commit2026-06-28: 1 commit2026-06-29: 8 commits2026-06-30: 9 commits2026-07-01: 10 commits2026-07-02: 14 commits2026-07-03: 6 commits2026-07-04: 0 commits2026-07-05: 0 commits2026-07-06: 9 commits2026-07-07: 6 commits2026-07-08: 13 commits2026-07-09: 5 commits2026-07-10: 4 commits2026-07-11: 2 commits2026-07-12: 0 commits2026-07-13: 12 commits2026-07-14: 9 commits2026-07-15: 6 commits2026-07-16: 8 commits2026-07-17: 13 commits2026-07-18: 0 commits2026-07-19: 1 commit2026-07-20: 15 commits2026-07-21: 11 commits2026-07-22: 15 commits2026-07-23: 10 commits2026-07-24: 9 commits2026-07-25: 1 commit2026-07-26: 4 commits2026-07-27: 5 commits2026-07-28: 9 commits2026-07-29: 7 commits2026-07-30: 8 commits2026-07-31: 8 commits2026-08-01: 1 commit2026-08-02: 1 commit2026-08-03: 8 commits2026-08-04: 14 commits2026-08-05: 10 commits2026-08-06: 14 commits2026-08-07: 13 commits2026-08-08: 2 commits2026-08-09: 0 commits2026-08-10: 9 commits2026-08-11: 17 commits2026-08-12: 7 commits2026-08-13: 7 commits2026-08-14: 4 commits2026-08-15: 1 commit2026-08-16: 0 commits2026-08-17: 2 commits2026-08-18: 5 commits2026-08-19: 2 commits2026-08-20: 4 commits2026-08-21: 8 commits2026-08-22: 0 commits2026-08-23: 1 commit2026-08-24: 8 commits2026-08-25: 14 commits2026-08-26: 3 commits2026-08-27: 7 commits2026-08-28: 7 commits2026-08-29: 0 commits2026-08-30: 0 commits2026-08-31: 3 commits2026-09-01: 10 commits2026-09-02: 5 commits2026-09-03: 7 commits2026-09-04: 2 commits2026-09-05: 0 commits2026-09-06: 0 commits2026-09-07: 6 commits2026-09-08: 2 commits2026-09-09: 6 commits2026-09-10: 13 commits2026-09-11: 6 commits2026-09-12: 0 commits2026-09-13: 0 commits2026-09-14: 4 commits2026-09-15: 2 commits2026-09-16: 4 commits2026-09-17: 2 commits2026-09-18: 2 commits2026-09-19: 0 commits2026-09-20: 0 commits2026-09-21: 0 commits2026-09-22: 3 commits2026-09-23: 1 commit2026-09-24: 0 commits2026-09-25: 0 commits2026-09-26: 0 commits2026-09-27: 1 commit2026-09-28: 1 commit2026-09-29: 1 commit2026-09-30: 1 commit2026-10-01: 0 commits2026-10-02: 0 commits2026-10-03: 0 commits2026-10-04: 0 commits2026-10-05: 0 commits2026-10-06: 0 commits2026-10-07: 0 commits2026-10-08: 3 commits2026-10-09: 1 commit2026-10-10: 0 commits2026-10-11: 0 commits2026-10-12: 1 commit2026-10-13: 1 commit2026-10-14: 1 commit2026-10-15: 0 commits2026-10-16: 0 commits2026-10-17: 0 commits2026-10-18: 0 commits2026-10-19: 0 commits2026-10-20: 0 commits2026-10-21: 0 commits2026-10-22: 0 commits2026-10-23: 0 commits2026-10-24: 0 commits2026-10-25: 0 commits2026-10-26: 0 commits2026-10-27: 1 commit2026-10-28: 1 commit2026-10-29: 4 commits2026-10-30: 0 commits2026-10-31: 0 commits2026-11-01: 0 commits2026-11-02: 1 commit2026-11-03: 0 commits2026-11-04: 6 commits2026-11-05: 2 commits2026-11-06: 0 commits2026-11-07: 0 commits2026-11-08: 0 commits2026-11-09: 2 commits2026-11-10: 2 commits2026-11-11: 0 commits2026-11-12: 1 commit2026-11-13: 1 commit2026-11-14: 0 commits2026-11-15: 0 commits2026-11-16: 0 commits2026-11-17: 0 commits2026-11-18: 0 commits2026-11-19: 0 commits2026-11-20: 0 commits2026-11-21: 0 commits
1,218 commits in the last yearLessMore

Signals and awards

derived from tracked data
  • Widely adopted

    18,162 stars

  • Very active

    1,218 commits in 52 weeks

  • Community-driven

    ~169 contributors

  • Permissive license

    MIT

  • Continuous integration

    Automated checks passing

  • Repeat trending

    3 trending appearances

What cli does

The Lark CLI is the official command-line interface developed by the larksuite team to interact with the Lark/Feishu ecosystem. It is uniquely designed to be used by both human operators and autonomous AI Agents, bridging the gap between terminal workflows and Lark's core business domains. The tool provides over 200 distinct commands covering Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, and Meetings. Additionally, it specifically exposes more than 20 formatted 'AI Agent Skills' to easily integrate Lark capabilities directly into custom AI pipelines. It delivers fast, reliable execution across all major operating systems.

Developers, system administrators, and AI engineers who heavily utilize Lark or Feishu in their organizations. Users need to be highly comfortable with terminal environments and API authentication concepts.

  • Extensive domain coverage: Offers complete command-line control over Messenger, Docs, Base, Sheets, Calendar, Mail, and Tasks.
  • Massive command library: Provides over 200 unique commands to automate and manage nearly every aspect of a Lark workspace.
  • AI agent skills: Exposes specifically formatted AI Agent Skills to seamlessly integrate Lark actions into autonomous agent workflows.
  • Official maintenance: Actively developed and maintained by the official larksuite team to ensure strict API compatibility.
  • Cross-platform architecture: Built in Go to deliver extremely fast, reliable, and single-binary execution across all major operating systems.

Where teams use it

Workflow automation

Developers use the extensive command library to write shell scripts that automatically update Sheets, send Messages, or manage Tasks.

AI agent integration

AI engineers embed the provided Agent Skills into their bots to grant them read and write access to the organization's Lark workspace.

Terminal-based management

Power users manage their calendars, emails, and documents entirely from the terminal without opening the heavy Lark desktop application.

CI/CD notifications

DevOps teams execute CLI commands within CI/CD pipelines to send automated build status messages directly to specific Lark chat groups.

Getting started: npx @larksuite/cli@latest install

README

main branch

lark-cli

License: MIT Go Version npm version

中文版 | English

The official Lark/Feishu CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Slides, Calendar, Mail, Tasks, Meetings, Markdown, and more, with 200+ commands and 26 AI Agent Skills.

Install · AI Agent Skills · Auth · Commands · Advanced · Enterprise · Security · Contributing

Why lark-cli?

  • Agent-Native Design — 24 structured Skills out of the box, compatible with popular AI tools — Agents can operate Lark with zero extra setup
  • Wide Coverage — 18 business domains, 200+ curated commands, 26 AI Agent Skills
  • AI-Friendly & Optimized — Every command is tested with real Agents, featuring concise parameters, smart defaults, and structured output to maximize Agent call success rates
  • Open Source, Zero Barriers — MIT license, ready to use, just npm install
  • Up and Running in 3 Minutes — One-click app creation, interactive login, from install to first API call in just 3 steps
  • Secure & Controllable — Input injection protection, terminal output sanitization, OS-native keychain credential storage
  • Three-Layer Architecture — Shortcuts (human & AI friendly) → API Commands (platform-synced) → Raw API (full coverage), choose the right granularity

Personal or Enterprise?

You are... Recommended path
An individual developer — using lark-cli in your terminal or with your own AI Agent Follow the Quick Start below
Enterprise IT / ISV — embedding lark-cli into your own Agent or platform, with centralized credentials (database / Vault / config center), unified audit logging, and a restricted command surface Read Embed lark-cli in your Agent and the extension/ packages — extend via a wrapper main, no need to modify CLI source

💡 For AI Agents: append .md to any Open Platform doc URL to fetch it as raw Markdown, e.g. embed-feishu-cli-in-agent.md.

Features

Category Capabilities
📅 Calendar View, create and update events, invite attendees, find meeting rooms, RSVP to invitations, check free/busy & time suggestions
💬 Messenger Send/reply messages, create and manage group chats, view chat history & threads, search messages, download media
📄 Docs Create, read, update, and search documents, read/write media & whiteboards
📁 Drive Upload and download files, search docs & wiki, manage comments
📝 Markdown Create, fetch, patch, and overwrite Drive-native .md files
📊 Base Create and manage tables, fields, records, views, dashboards, workflows, forms, roles & permissions, data aggregation & analytics
📈 Sheets Create, read, write, append, find, and export spreadsheet data
🖼️ Slides Create and manage presentations, read presentation content, and add or remove slides
✅ Tasks Create, query, update, and complete tasks; manage task lists, subtasks, comments & reminders
📚 Wiki Create and manage knowledge spaces, nodes, and documents
👤 Contact Search users by name/email/phone, get user profiles
📧 Mail Browse, search, read emails, send, reply, forward, manage drafts, watch new mail
🎥 Meetings Search live and historical meetings, inspect participants and artifacts, analyze transcripts, manage Minutes, and assist in meetings
🕐 Attendance Query personal attendance check-in records
✍️ Approval Query approval tasks, approve/reject/transfer tasks, cancel and CC instances
🎯 OKR Query, create, update OKRs; manage objective & key results, alignments, indicators and progress.
📋 Project Meegle — manage work items, schedules, and data via the standalone meegle-cli (install separately)
🔗 Apps Create Spark/Miaoda apps, publish HTML/static sites, run cloud generation, and manage access scope

Installation & Quick Start

Requirements

Before you start, make sure you have:

  • Node.js (npm/npx)
  • Go v1.23+ and Python 3 (only required for building from source)

Quick Start (Human Users)

Note for AI assistants: If you are an AI Agent helping the user with installation, jump directly to Quick Start (AI Agent), which contains all the steps you need to complete.

Install

Choose one of the following methods:

Option 1 — From npm (recommended):

npx @larksuite/cli@latest install

Option 2 — From source:

Requires Go v1.23+ and Python 3.

git clone https://github.com/larksuite/cli.git
cd cli
make install

# Install CLI SKILL (required)
npx skills add larksuite/cli -y -g
Configure & Use
# 1. Configure app credentials (one-time, interactive guided setup)
lark-cli config init

# 2. Log in (--recommend auto-selects commonly used scopes)
lark-cli auth login --recommend

# 3. Start using
lark-cli calendar +agenda

Quick Start (AI Agent)

The following steps are for AI Agents. Some steps require the user to complete actions in a browser.

Step 1 — Install

npx @larksuite/cli@latest install

Step 2 — Configure app credentials

Run this command in the background. It will output an authorization URL — extract it and send it to the user. The command exits automatically after the user completes the setup in the browser.

lark-cli config init --new

Step 3 — Login

Same as above: run in the background, extract the authorization URL and send it to the user.

lark-cli auth login --recommend

Step 4 — Verify

lark-cli auth status

Agent Skills

Skill Description
lark-shared App config, auth login, identity switching, scope management, security rules (auto-loaded by all other skills)
lark-calendar Calendar events (create/update), agenda view, free/busy queries, time suggestions, room finding, RSVP replies
lark-im Send/reply messages, group chat management, message search, upload/download images & files, reactions
lark-doc Create, read, update, search documents (Markdown-based)
lark-drive Upload, download files, manage permissions & comments
lark-markdown Create, fetch, patch, and overwrite Drive-native Markdown files
lark-sheets Create, read, write, append, find, export spreadsheets
lark-slides Create and manage presentations, read presentation content, and add or remove slides
lark-base Tables, fields, records, views, dashboards, data aggregation & analytics
lark-task Tasks, task lists, subtasks, reminders, member assignment
lark-mail Browse, search, read emails, send, reply, forward, draft management, watch new mail
lark-contact Search users by name/email/phone, get user profiles
lark-wiki Knowledge spaces, nodes, documents
lark-event Real-time event subscriptions (WebSocket), regex routing & agent-friendly format
lark-meeting Search live or historical meetings, inspect participants and artifacts, analyze transcripts, manage Minutes, and assist in meetings
lark-whiteboard Whiteboard/chart DSL rendering
lark-openapi-explorer Explore underlying APIs from official docs
lark-skill-maker Custom skill creation framework
lark-attendance Query personal attendance check-in records
lark-approval Query approval tasks, approve/reject/transfer tasks, cancel and CC instances
lark-workflow-meeting-summary Workflow: meeting minutes aggregation & structured report
lark-workflow-standup-report Workflow: agenda & todo summary
lark-okr Query, create, update OKRs; manage objective & key results, alignments and indicators.

Authentication

Command Description
auth login OAuth login with interactive selection or CLI flags for scopes
auth logout Sign out and remove stored credentials
auth status Show current login status and granted scopes
auth check Verify a specific scope (exit 0 = ok, 1 = missing)
auth scopes List all available scopes for the app
auth list List all authenticated users
# Interactive login (TUI guides domain and permission level selection)
lark-cli auth login

# Filter by domain
lark-cli auth login --domain calendar,task

# Recommended auto-approval scopes
lark-cli auth login --recommend

# Exact scope
lark-cli auth login --scope "calendar:calendar:read"

# Agent mode: return verification URL immediately, non-blocking
lark-cli auth login --domain calendar --no-wait
# Resume polling later
lark-cli auth login --device-code <DEVICE_CODE>

# DPoP (Demonstrating Proof of Possession) is enabled in preferred mode by default for new local credentials
lark-cli config set dpop preferred
# Or disable DPoP
lark-cli config set dpop disabled
# Or require DPoP without Bearer fallback
lark-cli config set dpop required
# Re-authorize after choosing a different policy
lark-cli auth login

# Identity switching: execute commands as user or bot
lark-cli calendar +agenda --as user
lark-cli im +messages-send --as bot --chat-id "oc_xxx" --text "Hello"

Three-Layer Command System

The CLI provides three levels of granularity, covering everything from quick operations to fully custom API calls:

1. Shortcuts

Prefixed with +, designed to be friendly for both humans and AI, with smart defaults, table output, and dry-run previews.

lark-cli calendar +agenda
lark-cli im +messages-send --chat-id "oc_xxx" --text "Hello"
lark-cli docs +create --doc-format markdown --content $'<title>Weekly Report</title>\n# Progress\n- Completed feature X'

Run lark-cli <service> --help to see all shortcut commands.

2. API Commands

Auto-generated from Lark OAPI metadata, curated through evaluation and quality gates — 100+ commands mapped 1:1 to platform endpoints.

lark-cli calendar calendars list
lark-cli calendar events instance_view --params '{"calendar_id":"primary","start_time":"1700000000","end_time":"1700086400"}'

3. Raw API Calls

Call any Lark Open Platform endpoint directly, covering 2500+ APIs.

lark-cli api GET /open-apis/calendar/v4/calendars
lark-cli api POST /open-apis/im/v1/messages --params '{"receive_id_type":"chat_id"}' --data '{"receive_id":"oc_xxx","msg_type":"text","content":"{\"text\":\"Hello\"}"}'

Advanced Usage

Output Formats

--format json      # Full JSON response (default)
--format pretty    # Human-friendly formatted output
--format table     # Readable table
--format ndjson    # Newline-delimited JSON (for piping)
--format csv       # Comma-separated values

JSON Output Contract

With --format json (the default), success and error envelopes are distinct.

Success goes to stdout, exit code 0:

{ "ok": true, "identity": "user", "data": { "guid": "..." }, "meta": { "count": 1 } }

Errors go to stderr, non-zero exit code:

{ "ok": false, "identity": "user", "error": { "type": "api", "subtype": "...", "code": 99991679, "message": "...", "hint": "..." } }

To check whether a command succeeded, test ok == true (or the exit code) — not code == 0. Unlike raw OpenAPI responses ({"code": 0, "msg": "ok", ...}), the success envelope carries no code or msg field; code appears only inside error as the upstream OpenAPI code. See errs/ERROR_CONTRACT.md for the full error taxonomy.

Pagination

--page-all                  # Auto-paginate through all pages
--page-limit 5              # Max 5 pages
--page-delay 500            # 500ms between page requests

Dry Run

For commands that may have side effects, preview the request with --dry-run first:

lark-cli im +messages-send --chat-id oc_xxx --text "hello" --dry-run

Schema Introspection

Use schema to inspect any API method's parameters, request body, response structure, supported identities, and scopes:

lark-cli schema
lark-cli schema calendar.events.instance_view
lark-cli schema im.messages.delete

Security & Risk Warnings (Read Before Use)

This tool can be invoked by AI Agents to automate operations on the Lark/Feishu Open Platform, and carries inherent risks such as model hallucinations, unpredictable execution, and prompt injection. After you authorize Lark/Feishu permissions, the AI Agent will act under your user identity within the authorized scope, which may lead to high-risk consequences such as leakage of sensitive data or unauthorized operations. Please use with caution.

To reduce these risks, the tool enables default security protections at multiple layers. However, these risks still exist. We strongly recommend that you do not proactively modify any default security settings; once relevant restrictions are relaxed, the risks will increase significantly, and you will bear the consequences.

We recommend using the Lark/Feishu bot integrated with this tool as a private conversational assistant. Do not add it to group chats or allow other users to interact with it, to avoid abuse of permissions or data leakage.

To reduce the security risks associated with access token theft, the CLI sends a minimal set of risk-control signals with OpenAPI requests made to exact official Feishu/Lark HTTPS domains. These signals are used to help identify anomalous API activity. This protection is enabled by default. The information sent is limited to:

  • Operating system type: macOS, Windows, or Linux
  • Device hardware model: for example, Mac17,9

To disable this protection for the current workspace, run:

lark-cli config risk-control off

To enable this protection for the current workspace, run:

lark-cli config risk-control on

To restore the default policy for the current workspace, run:

lark-cli config risk-control default

Please fully understand all usage risks. By using this tool, you are deemed to voluntarily assume all related responsibilities.

Contributing

Community contributions are welcome! If you find a bug or have feature suggestions, please submit an Issue or Pull Request.

For major changes, we recommend discussing with us first via an Issue.

Before opening a PR, see AGENTS.md for the local build, test, and PR checklist used by contributors and AI agents.

License

This project is licensed under the MIT License. When running, it calls Lark/Feishu Open Platform APIs. To use these APIs, you must comply with the following agreements and privacy policies:

View on GitHub

Recent activity

commits and pull requests

Releases and announcements

111 total
  1. v1.0.100v1.0.100Nov 10, 2026116.6K downloads

    ## Changelog * 0d0782f252f957bdf3308317322a55e8a6630ac8 fix(apps): classify database precondition subcodes (#2900) * fbb292df233aa0540acdba300d9ea7bec38389a0 fix(apps): name export's real gate and reject unusable ids and paths (#2899) * 7dbefd9cf17357545450ca53007d413212bc8aba fix(apps): recognize feishuapp runtime domains (#2906) * 05ac58ffa089fe7a171205ac1d1e97ee50196ec8 fix: scope apps recovery hints to failure causes (#2897)

  2. v1.0.99v1.0.99Nov 4, 2026133.2K downloads

    ## Changelog * 017b19a793ad71794a02887ede04757f3d82e10d chore(slides): sync XML schema (2026-10-13) (#2806) * a92db8779c0959bc14beb69d82fb262123cfb79b docs(apps): align cloud-dev polling guidance with session-get response (#2851) * 76f7e7eb92a511470b7a261ce8b82f9f4579d8c1 feat(apps): add +delete shortcut (#2883) * c910e89e97e98a458a051c50dbd36de43a603d30 feat(apps): add +features and +feature-enable for app business features (#2816) * 46c434f5a43f24997019e3c7f4062404c3a4ad09 feat(apps): add --owner-id filter to apps +list (#2884) * f31194b461afbd75479d12850b0f9cb9427cb762 feat(apps): support changing app icon via +update --icon-url/--icon-file (#2857) * ecfe7f3f5af7bf844af858e52c21386eb68fee46 feat(event): support drive.notice.comment_add_v1 comment notices (#2846) * daeed8575c9393f7ed633f39e69a6b47c60fa658 feat(task): register comment API metadata (#2864) * d5209485e57a0c2205ab88959811bfefe905ce29 fix(apps): answer rate-limited calls with backoff instead of request hints (#2882) * 782a5a4db906ed4914223838cc98b129c60b0dab fix(apps): tell git to quit when the credential helper cannot answer (#2854) * 74991aa69d997506a196bb8fa514f435b4e9aa60 fix(auth): explain logins that receive no

  3. v1.0.98v1.0.98Oct 13, 2026542K downloads

    ## Changelog * 97f0dabe7b046f45cfd820453b8305aeed47a601 docs(apps): restrict creative-mode wording in skill guidance (#2801) * 9067ec079bfa0b1ae2266cd91d1c1ee4a1ce824d docs(base): add text cell mention example (#2802) * 64b0d51f1159dfac12be35f839103af86a93fdd9 docs(task): clarify section routing and workflows (#2795) * 7beffb086d7fa3c5b843d8affa7c089f49cfc65e feat(auth): add DPoP support (#2679) * 84c661addf66de2e3a4165cd04879e54859a8bfd feat(base)!: default record reads to ndjson (#2782) * 1d26c2283915a4f8e7d03a880ed0e4fae91309a8 feat: support URL rewriting extensions (#2595) * cff1bdadbf8c8ab6601330bfbfca8610f9292e84 feat: support manifest-based distribution updates (#2596)

  4. v1.0.97v1.0.97Sep 28, 2026334.2K downloads

    ## Changelog * 7bd7708fae3eb8c637e9cc1221ca310a2ab77cb2 feat: optimize the transfer event (#2750) * a079fd7a0f2e5f91ef2a45017175ac9b7435ee97 feat: propagate policy status_message to agents (#2384) * 32e14dea9041e7876c8b41aead963b10866267d1 feat: support release approval handoff (#2639) * 32d198896816e9416711468c20b14df3dbbc63f3 fix(apps): stop the db/file commands from misdirecting the caller on failure (#2719) * a3e6b9ef362e689a0af0a8aeedf4d4381012a0ef fix(drive): accept successful folder moves without a task ID (#2751) * 65877b497a764db6d58c6d0ffba8333227e90b6f fix(errors): prefer rendered OpenAPI messages (#2629) * ceace6d9349f827a5f5a646aac51e2c5ef428d48 fix(im): expose open IDs for calendar messages (#2752) * 341ee384fd668a963a68382cb48f73b8143879be fix: support unified input for IM messages (#2760)

  5. v1.0.96v1.0.96Sep 16, 2026301.3K downloads

    ## Changelog * 1d0285a70489d022c2dd10ab5f829d242ee39f75 docs(base): add view selection and lifecycle reference (#2729) * 0493db0cd1a10d6dd8a2295128bec3e319c7fbb0 feat(apps): add +export to download an app's source code as a zip (#2594) * b67a4e85b17e1ff0f8488dd7d2cb2e05f5ca2f6f feat(base): support dashboard NPS config (#2562) * d5a32489b93050c88a21e54784593dd3effd452b feat(sheets): accept the parameter spellings two reflow windows say callers write (#2710) * 7f4a15cca68b5cd05c161820e7a5e35f32f778f0 feat(slides): consolidate xml-get skill docs (#2662) * 2ca601ce6ba8251a563947ff69ce63652211f569 fix(apps): only treat a JSON body as export's error envelope, stream any other type (#2731) * c6315975730a2117c704d945ebc1677ae2160239 fix(base): repair skill references and clarify view creation (#2725) * 39aaf9fca0e08825b51f6d8c6c617bf781db761b fix(minutes): enforce deterministic search ordering (#2714) * d1ae4727324533f30b12c866f47f25a03f21f56d fix(skills): use GUIDE.md for nested suite guides (#2634) * acb176e68076015f00ed6f3293c1f1a839ad09b5 fix(vc): restrict meeting join and leave to bot (#2570) * 1bd78144e890c685726bd251ef8ee7710750e538 fix: restrict chat creation to tenant token (#2728

Code frequency

additions and deletions
+130.8K-130.8KWeek of 2026-03-22: +101,876 linesWeek of 2026-03-22: -75 linesWeek of 2026-03-29: +16,720 linesWeek of 2026-03-29: -2,200 linesWeek of 2026-04-05: +54,169 linesWeek of 2026-04-05: -11,792 linesWeek of 2026-04-12: +32,239 linesWeek of 2026-04-12: -6,878 linesWeek of 2026-04-19: +41,399 linesWeek of 2026-04-19: -6,413 linesWeek of 2026-04-26: +130,842 linesWeek of 2026-04-26: -12,341 linesWeek of 2026-05-03: +6,479 linesWeek of 2026-05-03: -359 linesWeek of 2026-05-10: +17,903 linesWeek of 2026-05-10: -690 linesWeek of 2026-05-17: +45,554 linesWeek of 2026-05-17: -4,419 linesWeek of 2026-05-24: +38,247 linesWeek of 2026-05-24: -4,535 linesWeek of 2026-05-31: +73,121 linesWeek of 2026-05-31: -25,850 linesWeek of 2026-06-07: +111,281 linesWeek of 2026-06-07: -14,572 linesWeek of 2026-06-14: +17,177 linesWeek of 2026-06-14: -4,807 linesWeek of 2026-06-21: +32,958 linesWeek of 2026-06-21: -3,726 linesWeek of 2026-06-28: +35,578 linesWeek of 2026-06-28: -77,474 linesWeek of 2026-07-05: +12,575 linesWeek of 2026-07-05: -2,073 linesWeek of 2026-07-12: +34,914 linesWeek of 2026-07-12: -3,240 linesWeek of 2026-07-19: +33,879 linesWeek of 2026-07-19: -6,403 linesWeek of 2026-07-26: +22,641 linesWeek of 2026-07-26: -1,374 linesWeek of 2026-08-02: +98,626 linesWeek of 2026-08-02: -12,754 linesWeek of 2026-08-09: +89,179 linesWeek of 2026-08-09: -68,585 linesWeek of 2026-08-16: +11,584 linesWeek of 2026-08-16: -6,770 linesWeek of 2026-08-23: +45,414 linesWeek of 2026-08-23: -8,661 linesWeek of 2026-08-30: +21,453 linesWeek of 2026-08-30: -12,120 linesWeek of 2026-09-06: +76,430 linesWeek of 2026-09-06: -8,125 linesWeek of 2026-09-13: +8,193 linesWeek of 2026-09-13: -1,979 linesWeek of 2026-09-20: +732 linesWeek of 2026-09-20: -146 linesWeek of 2026-09-27: +13,363 linesWeek of 2026-09-27: -1,479 linesWeek of 2026-10-04: +5,068 linesWeek of 2026-10-04: -589 linesWeek of 2026-10-11: +520 linesWeek of 2026-10-11: -27 linesWeek of 2026-10-18: +0 linesWeek of 2026-10-18: -0 linesWeek of 2026-10-25: +5,701 linesWeek of 2026-10-25: -1,129 linesWeek of 2026-11-01: +4,275 linesWeek of 2026-11-01: -109 linesWeek of 2026-11-08: +2,200 linesWeek of 2026-11-08: -386 linesWeek of 2026-11-15: +0 linesWeek of 2026-11-15: -0 linesMar 22, 2026Nov 15, 2026
+1.2M lines added, -312.1K removed over the last year.

Commits per week

last 52 weeks
930Week of 2025-11-23: 0 commitsWeek of 2025-11-30: 0 commitsWeek of 2025-12-07: 0 commitsWeek of 2025-12-14: 0 commitsWeek of 2025-12-21: 0 commitsWeek of 2025-12-28: 0 commitsWeek of 2026-01-04: 0 commitsWeek of 2026-01-11: 0 commitsWeek of 2026-01-18: 0 commitsWeek of 2026-01-25: 0 commitsWeek of 2026-02-01: 0 commitsWeek of 2026-02-08: 0 commitsWeek of 2026-02-15: 0 commitsWeek of 2026-02-22: 0 commitsWeek of 2026-03-01: 0 commitsWeek of 2026-03-08: 0 commitsWeek of 2026-03-15: 0 commitsWeek of 2026-03-22: 7 commitsWeek of 2026-03-29: 55 commitsWeek of 2026-04-05: 93 commitsWeek of 2026-04-12: 63 commitsWeek of 2026-04-19: 58 commitsWeek of 2026-04-26: 48 commitsWeek of 2026-05-03: 24 commitsWeek of 2026-05-10: 44 commitsWeek of 2026-05-17: 61 commitsWeek of 2026-05-24: 60 commitsWeek of 2026-05-31: 54 commitsWeek of 2026-06-07: 73 commitsWeek of 2026-06-14: 27 commitsWeek of 2026-06-21: 34 commitsWeek of 2026-06-28: 48 commitsWeek of 2026-07-05: 39 commitsWeek of 2026-07-12: 48 commitsWeek of 2026-07-19: 62 commitsWeek of 2026-07-26: 42 commitsWeek of 2026-08-02: 62 commitsWeek of 2026-08-09: 45 commitsWeek of 2026-08-16: 21 commitsWeek of 2026-08-23: 40 commitsWeek of 2026-08-30: 27 commitsWeek of 2026-09-06: 33 commitsWeek of 2026-09-13: 14 commitsWeek of 2026-09-20: 4 commitsWeek of 2026-09-27: 4 commitsWeek of 2026-10-04: 4 commitsWeek of 2026-10-11: 3 commitsWeek of 2026-10-18: 0 commitsWeek of 2026-10-25: 6 commitsWeek of 2026-11-01: 9 commitsWeek of 2026-11-08: 6 commitsWeek of 2026-11-15: 0 commitsNov 23, 2025Nov 15, 2026
1.2K commits in the last 52 weeks.

When work happens

weekday and hour
SunMonTueWedThuFriSat036912151821Sun 0:00 — 1 commitsSun 1:00 — 1 commitsSun 2:00 — 0 commitsSun 3:00 — 0 commitsSun 4:00 — 0 commitsSun 5:00 — 0 commitsSun 6:00 — 0 commitsSun 7:00 — 0 commitsSun 8:00 — 0 commitsSun 9:00 — 0 commitsSun 10:00 — 1 commitsSun 11:00 — 2 commitsSun 12:00 — 0 commitsSun 13:00 — 0 commitsSun 14:00 — 3 commitsSun 15:00 — 0 commitsSun 16:00 — 2 commitsSun 17:00 — 0 commitsSun 18:00 — 0 commitsSun 19:00 — 0 commitsSun 20:00 — 1 commitsSun 21:00 — 1 commitsSun 22:00 — 1 commitsSun 23:00 — 0 commitsMon 0:00 — 0 commitsMon 1:00 — 1 commitsMon 2:00 — 0 commitsMon 3:00 — 0 commitsMon 4:00 — 0 commitsMon 5:00 — 0 commitsMon 6:00 — 0 commitsMon 7:00 — 0 commitsMon 8:00 — 0 commitsMon 9:00 — 0 commitsMon 10:00 — 4 commitsMon 11:00 — 14 commitsMon 12:00 — 5 commitsMon 13:00 — 5 commitsMon 14:00 — 12 commitsMon 15:00 — 13 commitsMon 16:00 — 15 commitsMon 17:00 — 16 commitsMon 18:00 — 9 commitsMon 19:00 — 27 commitsMon 20:00 — 28 commitsMon 21:00 — 24 commitsMon 22:00 — 16 commitsMon 23:00 — 5 commitsTue 0:00 — 3 commitsTue 1:00 — 2 commitsTue 2:00 — 0 commitsTue 3:00 — 0 commitsTue 4:00 — 0 commitsTue 5:00 — 0 commitsTue 6:00 — 0 commitsTue 7:00 — 0 commitsTue 8:00 — 0 commitsTue 9:00 — 0 commitsTue 10:00 — 13 commitsTue 11:00 — 17 commitsTue 12:00 — 9 commitsTue 13:00 — 5 commitsTue 14:00 — 18 commitsTue 15:00 — 21 commitsTue 16:00 — 21 commitsTue 17:00 — 23 commitsTue 18:00 — 24 commitsTue 19:00 — 27 commitsTue 20:00 — 29 commitsTue 21:00 — 27 commitsTue 22:00 — 13 commitsTue 23:00 — 5 commitsWed 0:00 — 0 commitsWed 1:00 — 3 commitsWed 2:00 — 3 commitsWed 3:00 — 0 commitsWed 4:00 — 0 commitsWed 5:00 — 0 commitsWed 6:00 — 0 commitsWed 7:00 — 0 commitsWed 8:00 — 0 commitsWed 9:00 — 1 commitsWed 10:00 — 7 commitsWed 11:00 — 22 commitsWed 12:00 — 7 commitsWed 13:00 — 6 commitsWed 14:00 — 24 commitsWed 15:00 — 28 commitsWed 16:00 — 20 commitsWed 17:00 — 24 commitsWed 18:00 — 14 commitsWed 19:00 — 24 commitsWed 20:00 — 19 commitsWed 21:00 — 19 commitsWed 22:00 — 16 commitsWed 23:00 — 8 commitsThu 0:00 — 4 commitsThu 1:00 — 3 commitsThu 2:00 — 1 commitsThu 3:00 — 0 commitsThu 4:00 — 0 commitsThu 5:00 — 0 commitsThu 6:00 — 0 commitsThu 7:00 — 0 commitsThu 8:00 — 0 commitsThu 9:00 — 0 commitsThu 10:00 — 6 commitsThu 11:00 — 25 commitsThu 12:00 — 8 commitsThu 13:00 — 5 commitsThu 14:00 — 19 commitsThu 15:00 — 20 commitsThu 16:00 — 16 commitsThu 17:00 — 35 commitsThu 18:00 — 24 commitsThu 19:00 — 25 commitsThu 20:00 — 23 commitsThu 21:00 — 28 commitsThu 22:00 — 11 commitsThu 23:00 — 4 commitsFri 0:00 — 5 commitsFri 1:00 — 0 commitsFri 2:00 — 0 commitsFri 3:00 — 2 commitsFri 4:00 — 0 commitsFri 5:00 — 0 commitsFri 6:00 — 1 commitsFri 7:00 — 0 commitsFri 8:00 — 0 commitsFri 9:00 — 0 commitsFri 10:00 — 12 commitsFri 11:00 — 15 commitsFri 12:00 — 14 commitsFri 13:00 — 7 commitsFri 14:00 — 15 commitsFri 15:00 — 23 commitsFri 16:00 — 25 commitsFri 17:00 — 26 commitsFri 18:00 — 20 commitsFri 19:00 — 14 commitsFri 20:00 — 10 commitsFri 21:00 — 6 commitsFri 22:00 — 7 commitsFri 23:00 — 0 commitsSat 0:00 — 3 commitsSat 1:00 — 1 commitsSat 2:00 — 0 commitsSat 3:00 — 0 commitsSat 4:00 — 0 commitsSat 5:00 — 0 commitsSat 6:00 — 1 commitsSat 7:00 — 0 commitsSat 8:00 — 0 commitsSat 9:00 — 0 commitsSat 10:00 — 3 commitsSat 11:00 — 5 commitsSat 12:00 — 0 commitsSat 13:00 — 1 commitsSat 14:00 — 4 commitsSat 15:00 — 1 commitsSat 16:00 — 8 commitsSat 17:00 — 6 commitsSat 18:00 — 5 commitsSat 19:00 — 1 commitsSat 20:00 — 4 commitsSat 21:00 — 3 commitsSat 22:00 — 1 commitsSat 23:00 — 3 commits
Commit volume by weekday and hour (UTC). Larger dots mean more commits.
DateListRankStars gained
Mar 30, 2026daily#7+213
Mar 29, 2026daily#9+253
Mar 28, 2026daily#6+235
  • avelino/awesome-go

    A curated list of awesome Go frameworks, libraries and software

    195K stars · Go

  • kubernetes/kubernetes

    Production-Grade Container Scheduling and Management

    129.3K stars · Go

  • JuliusBrussee/caveman

    why use many token when few token do trick. Skill + local proxy for coding agents: shorter answers, smaller tool output, every original recoverable.

    121.8K stars · Go

  • microsoft/TypeScript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

    111.9K stars · Go

  • infiniflow/ragflow

    RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.

    94.5K stars · Go

  • caddyserver/caddy

    Fast and extensible multi-platform HTTP/1-2-3 web server with automatic HTTPS

    79.2K stars · Go