Lark CLI Skill: Events — Real-Time Event Subscriptions

What it is

This is a Lark/Feishu CLI skill for event-driven workflows. It provides WebSocket real-time event listening with regex-based routing and NDJSON output, designed for automation pipelines and integrations.

The skill is part of the Lark CLI, a command-line tool for the Lark/Feishu Open Platform. It is best for teams using Lark/Feishu for workplace collaboration who want to build event-driven automations.

How it saves time or tokens

Instead of polling the Lark API for changes, this skill uses WebSocket connections to receive events in real time. Regex routing filters events at the source, reducing noise in your pipeline. NDJSON output integrates directly with tools like jq, making it easy to chain event processing without writing custom parsers. The estimated token cost is around 500 tokens.

How to use

1. Install the Lark CLI and this skill:

npm install -g @larksuite/cli
npx skills add larksuite/cli -y -g

1. Configure authentication:

lark-cli config init
lark-cli auth login --recommend

1. Start listening for events with regex filtering

Example

# Listen for all message events
lark-cli events listen --pattern 'im.message.*'

# Filter to specific event types with NDJSON output
lark-cli events listen --pattern 'im.message.receive_v1' --format ndjson

# Pipe to jq for processing
lark-cli events listen --pattern 'im.message.*' --format ndjson | \
  jq '.event.message.content'

Related on TokRepo

• Automation tools — event-driven workflow automation
• API tools — API integration and management

Common pitfalls

• Not completing the auth setup before trying to listen for events
• Using overly broad regex patterns that flood your pipeline with irrelevant events
• Forgetting that WebSocket connections need to be re-established after network interruptions