lark-event

Streams Feishu event updates via WebSocket to NDJSON on stdout.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It eliminates the need to manually poll or manually parse Feishu event updates by streaming live events over a WebSocket long connection and emitting them as structured output.

Core Features & Use Cases

  • Real-time event subscription: Connects as a bot using App ID + App Secret and registers the exact event types you need.
  • NDJSON streaming output: Outputs one event per line to stdout so you can pipe into logs, processors, or event-driven automation.
  • Agent-friendly compact mode: Supports a compact format that flattens and extracts human-meaningful fields, enabling LLM/event pipelines with less noise.
  • Regex routing and file output: Routes events to different directories and/or writes each event to an individual file for downstream processing.

Quick Start

Run lark-cli event +subscribe with compact and quiet output to start streaming Feishu events as NDJSON to your terminal.

Frequently Asked Questions about lark-event

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

FAQPage Schema
How do I stream Feishu events in real time instead of polling?

Stream Feishu events in real time by subscribing to a WebSocket long connection and emitting each event as NDJSON to stdout. This eliminates manual polling, providing continuous live updates for messages, contacts, and calendar changes directly to your terminal or pipeline.

How do I get agent-friendly output from Feishu event subscriptions?

Get agent-friendly output from Feishu events by enabling compact mode, which flattens and extracts human-meaningful fields from the payload. This reduces noise, producing structured NDJSON lines optimized for LLM and event-driven automation pipelines.

Can I route specific Feishu events to different directories using regex?

You can route specific Feishu events to different directories using regex filtering. The Skill matches incoming event types against your regex patterns and writes each routed event to an individual file for targeted downstream processing.

Do I need an App ID and App Secret for Feishu bot automation?

You need an App ID and App Secret for Feishu bot authentication. The Skill uses these credentials to establish a WebSocket long connection and register your configurable event types for bot-only, event-driven automation.

What Feishu event types can I monitor with NDJSON streaming?

You can stream NDJSON for various Feishu event types including messages, contact changes, calendar updates, approvals, tasks, and drive updates. The Skill registers the exact event types you configure for your bot automation needs.

What is the best way to pipe Feishu WebSocket events to logs or processors?

The best way to pipe Feishu WebSocket events to logs or processors is streaming them as NDJSON to stdout. One event per line allows seamless piping into log files, event processors, or downstream automation scripts.