# lark-cli

> The official Lark/Feishu CLI tool built for humans and AI Agents, covering 17 business domains with 200+ commands and 24 AI Agent Skills.

lark-cli is the official command-line interface for Lark/Feishu, maintained by the larksuite team and designed for both human users and AI Agents. It covers 17 core business domains — including Messenger, Docs, Base, Sheets, Slides, Calendar, Mail, Tasks, Meetings, and more — with over 200 curated commands and 24 structured AI Agent Skills. The tool features a three-layer command architecture (Shortcuts → API Commands → Raw API), enabling everything from quick human-friendly operations to full platform API coverage. Licensed under MIT, it installs in minutes via npm and integrates natively with popular AI agent frameworks.

- **Agent-Native Design** — *24 structured Skills out of the box, compatible with popular AI tools so agents can operate Lark with zero extra setup.*
- **Wide Coverage** — *17 business domains and 200+ commands spanning Calendar, Messenger, Docs, Drive, Sheets, Slides, Base, Tasks, Wiki, Mail, Meetings, Attendance, Approval, OKR, and more.*
- **Three-Layer Command System** — *Shortcuts (prefixed with `+`) for humans and AI, auto-generated API Commands mapped 1:1 to platform endpoints, and Raw API calls covering 2500+ Lark Open Platform APIs.*
- **AI-Friendly Output** — *Every command is tested with real agents, featuring concise parameters, smart defaults, structured output formats (JSON, table, CSV, NDJSON), and pagination support.*
- **Quick Installation** — *Install via `npm install -g @larksuite/cli`, then run `lark-cli config init` and `lark-cli auth login` to be up and running in under 3 minutes.*
- **Secure & Controllable** — *Input injection protection, terminal output sanitization, and OS-native keychain credential storage keep credentials and data safe.*
- **Schema Introspection** — *Use `lark-cli schema` to inspect any API method's parameters, request body, response structure, supported identities, and required scopes.*
- **Open Source (MIT)** — *Free to use, modify, and distribute; community contributions via Issues and Pull Requests are welcome.*

## Features
- 200+ curated commands across 17 business domains
- 24 AI Agent Skills for agent-native automation
- Three-layer command system: Shortcuts, API Commands, Raw API
- 2500+ Raw API endpoint coverage
- Multiple output formats: JSON, pretty, table, NDJSON, CSV
- Auto-pagination support
- Dry-run preview for side-effect commands
- Schema introspection for any API method
- OAuth login with interactive scope selection
- Identity switching between user and bot
- OS-native keychain credential storage
- Input injection protection and terminal output sanitization
- Real-time event subscriptions via WebSocket
- Custom skill creation framework

## Integrations
Lark/Feishu Open Platform, npm, Node.js, Go, AI agent frameworks

## Platforms
WEB, API, CLI

## Pricing
Open Source

## Version
v1.0.23

## Links
- Website: https://github.com/larksuite/cli
- Documentation: https://github.com/larksuite/cli#readme
- Repository: https://github.com/larksuite/cli
- EveryDev.ai: https://www.everydev.ai/tools/lark-cli