lark-im

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

Updated Sep 4, 2025
One-click install
npx skills add https://github.com/ykai55/dotfiles --skill lark-im-ykai55
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-im
Source: https://github.com/ykai55/dotfiles/tree/main/opencode/skills/lark-im
Command: npx skills add https://github.com/ykai55/dotfiles --skill lark-im-ykai55

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

lark-im helps you reliably send, fetch, search, and moderate Feishu IM messages and group chats without manually navigating the client UI.

Core Features & Use Cases

  • Message operations: send messages, reply (including thread replies), fetch single or batch message details, and download message resources like images and files.
  • Chat discovery & moderation: search visible group chats, list chat messages, list thread replies, update group chat metadata, and manage group members.
  • Identity-aware execution: supports both user and bot identities with clear token/permission implications for success and failure handling.

Quick Start

Ask for the recent messages in a known group chat by running: lark-cli im +chat-messages-list --chat-id oc_xxx --format json

Frequently Asked Questions about lark-im

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

FAQPage Schema
How do I search Feishu IM messages by keywords?

To search Feishu IM messages by keywords, use lark-cli to retrieve and filter visible chats and chat messages based on specified text criteria. This enables authenticated message discovery without navigating the client UI.

Can I manage Feishu group chat members using a bot identity?

Yes, you can manage Feishu group chat members using a bot identity. lark-im supports identity-aware execution, allowing you to execute group membership workflows by selecting either user or bot identities to satisfy token permissions.

How do I download images and files referenced in Feishu chat messages?

You can download images and files referenced in Feishu chat messages by executing batch message detail retrieval and downloading the referenced message resources. lark-im handles authenticated media extraction from conversation content.

Does lark-cli require specific permissions to fetch Feishu chat history?

Yes, lark-cli requires correct identity selection and specific Feishu permissions to fetch chat history. You must authenticate and execute commands using either user or bot identity to satisfy Feishu token requirements for message retrieval.

What is the best way to reply to a specific message thread in Feishu IM?

The best way to reply to a specific message thread in Feishu IM is using lark-cli to list thread replies and send targeted responses. This enables precise thread reply manipulation without manual client interaction.

Why do my Feishu IM message retrieval commands fail with permission errors?

Feishu IM message retrieval commands fail with permission errors when the incorrect identity is selected. You must choose the appropriate user or bot identity using --as to ensure the token satisfies the required Feishu permission scopes.