SkillsMar 30, 2026·1 min read

Lark CLI Skill: Messenger — Chat & Messages

Lark/Feishu CLI skill for instant messaging. Send/reply messages, manage group chats, search chat history, upload/download media.

Agent ready

Safe staging for this asset

This asset is staged first. The copied prompt tells the agent to inspect the staged files and ask before activating scripts, MCP config, or global config.

Stage only · 17/100Policy: stage
Agent surface
Any MCP/CLI agent
Kind
CLI Tool
Install
Stage only
Trust
Trust: Community
Entrypoint
Lark CLI Skill: Messenger — Chat & Messages
Safe staging command
npx -y tokrepo@latest install 1f1d875f-a85e-45ec-b9ee-f469cb881b39 --target codex

Stages files first; activation requires review of the staged README and plan.

TL;DR
Lark CLI Messenger skill lets AI agents send messages, manage group chats, and search chat history in Lark/Feishu.
§01

What it is

The Lark CLI Messenger skill provides instant messaging capabilities for AI coding agents through the Lark/Feishu platform. It enables sending and replying to messages, managing group chats, searching chat history, and handling media uploads and downloads, all from the command line.

This skill is designed for developers and teams using Lark/Feishu who want their AI agents to communicate through the platform without switching to the Lark app.

§02

How it saves time or tokens

Without this skill, interacting with Lark messaging requires the web app or mobile app, breaking your flow during AI-assisted development. The CLI skill lets your AI agent send status updates, ask questions in group chats, or search for past conversations without leaving the terminal. This is particularly useful for automated workflows where an agent needs to notify a team channel about build results or deployment status.

§03

How to use

  1. Install the Lark CLI and the Messenger skill:
npm install -g @larksuite/cli
npx skills add larksuite/cli -y -g
  1. Configure authentication (one-time setup):
lark-cli config init
lark-cli auth login --recommend
  1. Send a message to a chat:
lark-cli messenger send --chat-id oc_xxxxx --text 'Build completed successfully'
§04

Example

Common Messenger skill commands:

# Send a text message
lark-cli messenger send --chat-id oc_xxxxx --text 'Deployment to staging is complete'

# Reply to a specific message
lark-cli messenger reply --message-id om_xxxxx --text 'Acknowledged, reviewing now'

# Search chat history
lark-cli messenger search --chat-id oc_xxxxx --query 'API endpoint'

# List group chats
lark-cli messenger list-chats

# Upload a file to a chat
lark-cli messenger upload --chat-id oc_xxxxx --file ./report.pdf
§05

Related on TokRepo

§06

Common pitfalls

  • Not completing the lark-cli auth login step before trying to send messages. Without authentication, all API calls will fail with permission errors.
  • Using the wrong chat ID format. Lark chat IDs start with oc_ for group chats. Use lark-cli messenger list-chats to find the correct ID.
  • Sending too many messages in rapid succession. Lark has API rate limits. Add delays between batch message operations to avoid being throttled.
  • Starting with an overly complex configuration instead of defaults. Begin with the minimal setup, verify it works, then customize incrementally. This approach catches configuration errors early and keeps troubleshooting straightforward.

Frequently Asked Questions

Does the Lark CLI Messenger work with Feishu?+

Yes. Lark and Feishu are the same platform (Lark is the international version, Feishu is the Chinese version). The CLI skill works with both. You configure the correct endpoint during lark-cli config init.

Can I send rich-text or card messages?+

The skill supports text messages and file uploads. For rich interactive card messages, you would need to use the Lark Open API directly, as card message construction requires JSON templates that are better handled programmatically.

How do I find the chat ID for a group?+

Run lark-cli messenger list-chats to see all group chats your authenticated user belongs to. Each chat shows its ID (starting with oc_), name, and member count.

Can an AI agent use this skill autonomously?+

Yes. Once authentication is configured, the CLI commands can be invoked by any process, including AI agents like Claude Code. The agent can send notifications, search for context in chat history, and respond to messages without human intervention.

Is there a message length limit?+

Lark text messages have a limit of approximately 4,000 characters. For longer content, consider sending a file attachment or splitting the message into multiple parts.

Citations (3)
🙏

Source & Thanks

Created by LarkSuite. Licensed under MIT. larksuite/cli — 4,100+ GitHub stars

Part of the Lark CLI Official Skills Collection on TokRepo.

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets