lark-mail

Compose, send, read, and manage Feishu mailbox emails via the lark-cli command line.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Managing a Feishu (Lark) mailbox from an AI assistant or terminal requires navigating dozens of raw API endpoints, MIME structures, and safety rules. This Skill wraps the lark-cli mail commands into guided workflows for drafting, sending, replying, forwarding, searching, and organizing email without hand-building API calls. ## Core Features & Use Cases - Full mail lifecycle: Draft, compose, send, reply, reply-all, forward, schedule, recall, and track delivery status, with drafts as the safe default before any send. - Mailbox organization: Manage folders, labels, contacts, attachments, mail rules, personal templates, signatures, and read receipts through shortcuts or native API resources. - HTML authoring and linting: Write Feishu-native HTML email bodies following verified formatting rules, preview lint fixes with +lint-html, and reuse official HTML templates. - Use Case: Ask the assistant to draft a weekly team report email with an HTML body and attachment, review the draft link in Feishu Mail, then confirm sending and check delivery status. ## Quick Start Ask the assistant to draft an email to a colleague with a subject and body using the lark-mail skill, then review the returned draft link before confirming the send.

Frequently Asked Questions about lark-mail

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

FAQPage Schema
How do I send an email with lark-cli mail?

Use the +send shortcut with --to, --subject, and --body to create a draft, then add --confirm-send only after the user explicitly confirms recipients and content. After sending, call the send_status API with the returned message_id to verify delivery.

How do I reply to or forward an email from the command line?

Use +reply or +reply-all with the message ID to create a reply draft, and +forward to forward. All three save drafts by default and automatically set Re:/Fwd: subjects and threading headers; add --confirm-send to send immediately after user confirmation.

Does lark-cli mail support HTML email bodies and inline images?

Yes, all compose shortcuts auto-detect HTML bodies and support inline images via relative paths like <img src="./logo.png" />, which are converted to cid: references. A built-in lint pass sanitizes HTML for Feishu compatibility, and +lint-html previews the fixes.

Can I schedule or recall an email with lark-cli?

Yes, pass --send-time with a Unix timestamp alongside --confirm-send to schedule delivery at least five minutes ahead. Sent messages can be recalled within 24 hours via user_mailbox.sent_messages recall, with progress checked through get_recall_detail.

Why does lark-cli mail require user identity for sending?

All write operations such as sending, replying, and draft editing only work with --as user, which requires completing lark-cli auth login --domain mail first. The bot identity is limited to read operations and needs corresponding app permissions.