lark-event

Subscribe to Feishu/Lark events via WebSocket and output NDJSON to stdout.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ShunsukeHayashi/lark-harness --skill lark-event-shunsukehayashi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-event
Source: https://github.com/ShunsukeHayashi/lark-harness/tree/main/lark-event
Command: npx skills add https://github.com/ShunsukeHayashi/lark-harness --skill lark-event-shunsukehayashi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Feishu/Lark events are hard to monitor in real time and feed into automation pipelines. This skill provides a WebSocket-based subscription and standard NDJSON output for downstream agents.

Core Features & Use Cases

  • Real-time subscription to Feishu events via WebSocket with NDJSON output to stdout.
  • Regex routing and optional file output to support streaming pipelines and offline analysis.
  • Agent-friendly formatting and clear separation of event types for easy integration with existing workflows.

Quick Start

Use lark-cli event +subscribe to start watching Feishu events over a WebSocket and emit NDJSON to stdout for downstream processing.

Frequently Asked Questions about lark-event

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

FAQPage Schema
How do I subscribe to Feishu events in real time over WebSocket?

To subscribe to Feishu events in real time over WebSocket, use the lark-cli event command to establish a connection and emit NDJSON output to stdout. It covers messages, contacts, calendar, and chat events.

What is the best way to monitor Lark chat events for an automation pipeline?

The best way to monitor Lark chat events for an automation pipeline is using a WebSocket subscription that outputs NDJSON. This provides agent-friendly formatting and clear separation of event types for easy integration with existing workflows.

Do I need lark-cli and Open Platform permissions to use Feishu event subscriptions?

Yes, you need lark-cli installed and proper Feishu Open Platform permissions configured to use real-time event subscriptions. These prerequisites allow the WebSocket connection to authenticate and receive messages, calendar, and contact events.

Can I route specific Feishu events to a file instead of stdout?

Yes, you can route specific Feishu events to a file instead of stdout. The subscription supports regex routing and optional file output, allowing you to filter event types and direct the NDJSON stream for offline analysis or streaming pipelines.

Why use NDJSON output for Feishu WebSocket event streams?

NDJSON output is used for Feishu WebSocket event streams because it provides standard, line-delimited formatting that downstream agents can easily parse. This agent-friendly formatting enables real-time event-driven pipelines and monitoring without complex deserialization.