rooma

Stream Feishu chat events and send replies, files, and reactions via CLI subcommands.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/bencode/rooma --skill rooma
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rooma
Source: https://github.com/bencode/rooma/tree/main/.claude/skills/rooma
Command: npx skills add https://github.com/bencode/rooma --skill rooma

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

rooma removes the “one-shot reply” limitation of typical chat integrations by letting an AI agent stay present in Feishu chats, listen to ambient context in real time, and take action when mentioned or when a clear task appears.

Core Features & Use Cases

  • Live WS event streaming: streams inbound Feishu messages into the Claude Code conversation as JSON events with mention awareness.
  • Chat discovery and context building: supports fetching chat lists, members, and room purpose (including pinned announcements) before responding.
  • Action orchestration: sends messages and files, reacts with completion acknowledgements, and escalates to humans with targeted help requests.
  • Session-aware broadcast & farewell: posts a “start working” broadcast to selected chats and automatically sends a farewell on session end (when supported by the hook).

Example use case: when a project question appears in a group where the bot is @-mentioned, rooma pulls recent context, consults the room’s stated purpose/announcement, then responds briefly while marking completion with a reaction if appropriate.

Quick Start

Tell the skill to start a Feishu collaboration session by saying “start feishu”, then wait for the monitor stream to come online and respond to the next @-mention event.

Frequently Asked Questions about rooma

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

FAQPage Schema
How do I keep an AI agent live in a Feishu chat to monitor real-time messages?

You can keep an AI agent live in a Feishu chat by launching a WebSocket monitor that streams inbound messages as actionable JSON events, enabling the agent to listen to ambient context and respond when mentioned.

Can a Feishu chat bot pull room context and member lists before sending an automated reply?

Yes, a Feishu chat bot can pull room context and member lists by using CLI subcommands to fetch chat information, members, and pinned announcements before orchestrating an automated reply or reaction.

How does WebSocket event streaming work for agent collaboration in Feishu?

WebSocket event streaming for agent collaboration works by tailing JSON stdout events from a WS monitor in real time, allowing the AI agent to process p2p messages, group @-mentions, and ambient chatter.

What is the best way to automate message escalation to humans in a Feishu group?

The best way to automate message escalation to humans in a Feishu group is by using the provided CLI subcommands to send targeted help requests when the agent decides a task requires human intervention.

Does this real-time Feishu bot approach support sending files and reactions?

Yes, this real-time Feishu bot approach supports sending files and reactions through specific CLI subcommands, allowing the agent to acknowledge task completion or share documents directly in the chat.

When should I not use a live WS monitor for message automation in Feishu?

You should not use a live WS monitor for message automation if your use case only requires a single one-shot reply, as this approach is designed for persistent session-aware collaboration and context building.