lark-im

Send, search, and manage Feishu messages and group chats via lark-cli.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/TrayMachi/dotfiles --skill lark-im-traymachi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-im
Source: https://github.com/TrayMachi/dotfiles/tree/main/agents/skills/lark-im
Command: npx skills add https://github.com/TrayMachi/dotfiles --skill lark-im-traymachi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lark-cli, and includes references (resource) components.

What problem does it solve? Operating Feishu (Lark) instant messaging programmatically requires navigating dozens of OpenAPI endpoints, identity rules, and permission scopes. This Skill wraps the lark-cli IM surface into documented shortcuts so an AI agent can send messages, search chats, and manage groups without guessing API shapes. ## Core Features & Use Cases - Messaging: Send, reply, forward, recall, and search messages across group and P2P chats, with automatic reaction enrichment and optional resource download (images, files, chunked large-file downloads). - Chat Management: Create group or topic chats, update names/descriptions, manage members, managers, moderation, and pins under correct user/bot identity rules. - Feed & Bookmarks: Manage message flags, feed shortcuts (pinned chats), and feed groups (tags) with user-identity APIs. - Use Case: Ask the agent to find the "release team" group, list the last 50 messages, download attached files, and pin the chat to your feed sidebar — all executed through lark-cli shortcuts. ## Quick Start Ask the agent to send a message saying "deployment complete" to the Feishu group named release-team using the lark-im skill.

Frequently Asked Questions about lark-im

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a message to a Feishu group chat from the command line?

Use the lark-cli im +messages-send shortcut with --chat-id and --text, or --user-id for direct messages. If you only know the group name, resolve its chat_id first with lark-cli im +chat-search --query.

How to search Feishu chat history with lark-cli?

Use lark-cli im +messages-search with user identity, filtering by keyword, sender, chat, or time range. It supports auto-pagination via --page-all and enriches results with sender names through batched lookups.

Should I use --as user or --as bot for Feishu IM operations?

User identity uses user_access_token and has broader contact access; bot identity uses tenant_access_token and is limited by app visibility. Feed shortcuts, flags, and message search are user-only, while urgent messages and merge forward are bot-only.

Can I download files and images from Feishu messages?

Yes. Pass --download-resources to message listing commands to save eligible resources into ./lark-im-resources/, or use +messages-resources-download for one-off downloads with automatic 8MB chunked transfer for large files. Stickers are not downloadable.

Why does adding members to a Feishu group fail with error 232043?

Error 232043 means the bot and target users are mutually invisible due to app visibility settings. Create the group with the bot first, then add members with user identity via chat.members create so the request is not blocked.

What permissions does lark-cli IM need?

Each API maps to a scope such as im:message:readonly for reading messages, im:chat:create for creating groups, and im:feed_group_v1:write for feed tags. Missing scopes are fixed by enabling them in the Open Platform console or running lark-cli auth login --scope.