Skip to content

hibira-io/hibira

v0.8.0MIT

Hibira realtime for AI coding agents: the Hibira MCP server plus skills for wiring channels, push notifications, AI streaming, human approvals, waiting rooms and the Chat API into your app, adding the Live Chat widget and knowledge base, and asking a Gaya panel for a second opinion.

Hibira agent plugin

Hibira for AI coding agents: the Hibira MCP server plus skills that teach your agent to wire Hibira realtime channels, push notifications, AI streaming, human approvals, in-app chat (Chat API) and virtual waiting rooms into your app; the Hibira Live Chat MCP server and skills for the chat widget, its knowledge base and single sign-on; and the Gaya MCP server for a second opinion from a group of AI personas.

Add to Cursor Install in VS Code

Install

ClientSkillsMCPHow
Claude Code✅✅Marketplace
Codex CLI✅✅Marketplace
GitHub Copilot CLI✅✅Marketplace
Gemini CLI✅✅Extension
Cursor✅✅Plugin or one click
VS Code (Copilot Chat)✅✅Plugin or one click
OpenCode✅✅Config
Windsurf, Cline, Kilo, Zed, Amp, Continue, …✅✅npx skills + MCP URL
Claude.ai, ChatGPT—✅Custom connector

The MCP server signs in with OAuth. There is no API key to paste: the first Hibira tool call (or the client's MCP login command) opens a Hibira consent page, where you choose read only or read and write, and which apps the agent may use.

Claude Code

claude plugin marketplace add hibira-io/agent-plugin
claude plugin install hibira@hibira

Then run /mcp, pick hibira and sign in.

Codex CLI

codex plugin marketplace add hibira-io/agent-plugin
codex plugin add hibira@hibira
codex mcp login hibira

Or run codex, type /plugins and install Hibira from there.

GitHub Copilot CLI

copilot plugin marketplace add hibira-io/agent-plugin
copilot plugin install hibira@hibira

Gemini CLI

gemini extensions install https://github.com/hibira-io/agent-plugin

Then /mcp auth hibira inside Gemini CLI.

Cursor

Whole plugin (skills and MCP):

git clone https://github.com/hibira-io/agent-plugin.git ~/.cursor/plugins/local/hibira

and restart Cursor. MCP only: click Add to Cursor above, or add to .cursor/mcp.json:

{ "mcpServers": { "hibira": { "url": "https://hibira.io/mcp" } } }

VS Code

Whole plugin: clone this repository, open the Chat view, go to Plugins and add the folder. MCP only: click Install in VS Code above, or add to .vscode/mcp.json:

{ "servers": { "hibira": { "type": "http", "url": "https://hibira.io/mcp" } } }

OpenCode

npx skills add hibira-io/agent-plugin -a opencode

and in opencode.json:

{ "mcp": { "hibira": { "type": "remote", "url": "https://hibira.io/mcp" } } }

Then opencode mcp auth hibira.

Other agents

Any agent that reads SKILL.md folders can take the skills with skills, and any MCP client can use the server URL:

npx skills add hibira-io/agent-plugin          # add -a <agent> for one client, -g for global
npx add-mcp https://hibira.io/mcp

Clients that read the Agent Plugins manifest (plugin.json, mcp.json) can load a clone of this repository directly.

What you get

MCP servers

  • hibira (https://hibira.io/mcp): list and create apps, read usage, get the setup guide for your SDK with your app's values filled in, send a test event and watch the debug console, see who is on which channel, configure and test webhooks, rotate a secret or delete an app (each only after you confirm the app's name), publish events, send push notifications, ask a person for approval, and run waiting rooms (create, open, pause, close, admit).
  • hibira-live-chat (https://chat.hibira.io/mcp): for Hibira Live Chat owners and admins. Read the workspace's single sign-on setup, get the signing code for your stack with your workspace filled in, check the tokens your code signs (without signing anyone in), list agents and turn on "only single sign-on". It never sees your SSO secret.
  • gaya (https://gaya.hibira.io/mcp): ask a Gaya group of AI personas a question and get their verdict back, then follow up in the room. Rooms use your own Gaya account's AI replies.

Each server signs in separately, the first time you use it.

Skills

SkillUse it for
get-startedFirst run: sign in, pick or create an app, send a first test event
hibira-mcp-usageWhen and how to call the MCP tools safely
realtime-integrationChannels in web, mobile and backend projects (pusher-js, Laravel, Flutter, server SDKs)
migrate-from-pusherMoving a Pusher Channels or Beams project to Hibira
push-notificationsHibira Push for iOS, Android and browsers
ai-streamingResumable Vercel AI SDK chat with @hibira-io/ai-sdk
agent-approvalsHuman-in-the-loop approvals for agents and workflows
chat-apiIn-app chat with stored history, unread counts and read receipts (Chat API, beta)
waiting-roomA virtual waiting room (queue) in front of a ticket drop or flash sale, in any framework
livechat-ssoStaff open the Hibira Live Chat inbox from your own admin panel (single sign-on)
livechat-widgetThe Hibira Live Chat widget on your site, in any framework, opened from your own buttons
livechat-knowledgeA Live Chat knowledge base file written from your FAQ and help pages, imported in one click
gaya-ask-groupA second opinion from a Gaya group of AI personas, with the verdict and room link
gaya-reviewA Gaya panel's reaction to your copy, naming, pricing or plan, turned into edits

Try: "Add live order updates to this app with Hibira", "Move this project from Pusher to Hibira" "Put a waiting room in front of our ticket drop page" "Connect our admin panel to Hibira Live Chat single sign-on", "Add Hibira Live Chat to this site and fill its knowledge base from our FAQ" or "Ask Gaya which of these two headlines works better".

No plugin? Paste the short rules snippet from hibira.io/mcp-server into CLAUDE.md, AGENTS.md or a Cursor rule.

Repository layout

PathFor
skills/The skills, shared by every client
.mcp.jsonMCP server (Claude Code, Codex, Cursor, Copilot, VS Code)
.claude-plugin/Claude Code plugin and marketplace (also read by Copilot CLI and VS Code)
.codex-plugin/, .agents/plugins/Codex plugin and marketplace
.cursor-plugin/Cursor plugin
gemini-extension.jsonGemini CLI extension
plugin.json, mcp.jsonAgent Plugins manifest
openai/submission.jsonChatGPT plugin directory review data (test cases, release notes, translations)

Run node scripts/check.mjs after changing a manifest: it checks that every manifest carries the same version and MCP URLs.

For the ChatGPT plugin directory, node scripts/openai-zip.mjs [demo-video-url] writes dist/hibira-chatgpt.zip: the Codex manifest plus openai/submission.json, the hibira MCP server only (the directory takes one server per plugin) and every skill except the Live Chat and Gaya ones. Upload it at platform.openai.com/plugins.

License

MIT


中文摘要

Hibira 的 AI 編程助手外掛:接上 Hibira MCP 伺服器(OAuth 登入,不需 API key),並附 14 個技能,讓助手能在你的專案裡接上即時頻道、推播、AI 串流、人工審核、聊天(Chat API)與排隊等候室(建立、開放、暫停、售罄、放行,並在任何框架裡驗證 pass),也能協助從 Pusher 遷移。另含 Hibira 即時客服的 MCP 伺服器(https://chat.hibira.io/mcp),可幫你把自家後台接上即時客服的單一登入,讓客服從後台直接打開收件匣;它看不到你的 SSO 密鑰。新技能可把即時客服小工具裝到任何網站,並把你的 FAQ 和說明頁整理成知識庫 JSON 檔一鍵匯入。也含 Gaya 的 MCP 伺服器(https://gaya.hibira.io/mcp),可請一群 AI 角色討論問題或評估文案、命名與定價,帶回結論和房間連結。沒有外掛的話,可到 hibira.io/mcp-server 複製一段規則貼進 CLAUDE.md、AGENTS.md 或 Cursor 規則。支援 Claude Code、Codex、Copilot CLI、Gemini CLI、Cursor、VS Code、OpenCode,其他工具可用 npx skills add hibira-io/agent-plugin 加上 MCP 網址 https://hibira.io/mcp。ChatGPT 外掛目錄用 node scripts/openai-zip.mjs 產生上傳用 ZIP(只含 hibira 一個 MCP 伺服器)。