![\"LINE](\"assets/logo-line-hive.svg\"){kind=logo}
\n\n \n
\n Your editor agents talk to you in LINE.
\n An MCP server that bridges AI agents (Copilot, Cursor, Claude) to LINE Messaging — check progress, answer questions, and get alerts without touching your computer.\n
\n ![\"npm](\"https://img.shields.io/npm/v/@zoulabo/line-hive?color=cb3837&label=npm\")
![\"Node.js](\"https://img.shields.io/badge/node-%3E%3D18-brightgreen\"){kind=icon}
![\"MIT](\"https://img.shields.io/badge/license-MIT-blue\"){kind=icon}
![\"475](\"https://img.shields.io/badge/tests-475%20passing-brightgreen\"){kind=icon}
\n Works with VS Code Copilot · Cursor · Claude Code · Claude Desktop · any MCP client\n
\n\n---\n\n**Why?** AI agents run long tasks and need your input. LINE Hive lets you check status or reply from your phone — no editor watching required.\n\n## Features\n\n- 📱 **Check from anywhere** — query agent status from LINE with `?`, get instant updates\n- 💬 **Two-way conversation** — agents ask you questions, you reply from your phone\n- 🤖 **Multi-agent** — multiple editors share one bot; select by number\n- ↩️ **Quote-reply routing** — quote an agent's message to auto-switch targeting\n- 🆓 **Free tier friendly** — status queries use reply tokens (free), not push quota\n- 📎 **File exchange** — send images, PDFs, and documents; agents read content on demand\n- 🔍 **PDF intelligence** — text extraction, scanned PDF→image rendering, per-page navigation\n- 🌐 **Multi-language** — English and Japanese, auto-detected from LINE profile\n- 🔧 **Zero config tunnel** — built-in ngrok management (or bring your own tunnel)\n- 🛡️ **Security hardened** — workspace-scoped file access, path containment, sandboxed PDF parsing\n- � **Interactive file browser** — agents send browsable file/folder links; view code with syntax highlighting and rendered Markdown in LINE's in-app browser\n- �🔐 **Access control** — first user is auto-registered as primary admin; restricted mode activates on follow or status check, blocking other users by default\n\n## Contents\n\n- [Features](#features)\n- [Companion: Doc Hive](#companion-doc-hive)\n- [Quick Start](#quick-start)\n- [How It Works](#how-it-works)\n- [Prerequisites](#prerequisites)\n- [Setup](#setup) — [LINE Account](#1-create-a-line-official-account) · [Webhook Tunnel](#2-set-up-a-webhook-tunnel) · [Install](#3-install-line-hive-in-your-project)\n- [Your First Message](#your-first-message)\n- [Updating](#updating)\n- [MCP Tools](#mcp-tools)\n- [LINE Commands](#line-commands)\n- [Language Support](#language-support)\n- [Limitations](#limitations)\n- [Development](#development)\n- [Contributing](#contributing)\n- [Troubleshooting](#troubleshooting)\n- [Architecture](#architecture)\n- [License](#license)\n\n## Companion: Doc Hive\n\nLINE Hive handles **communication** — [Doc Hive](../doc-hive/) handles **documents**. Together, your agents can generate polished spreadsheets, slide decks, and Word documents, then deliver them straight to your phone via LINE.\n\n```mermaid\n%%{init: {\"theme\": \"default\"}}%%\nflowchart TB\n subgraph Generate[\"📄 Doc Hive\"]\n direction LR\n XLSX[\"create_xlsx\"] ~~~ DOCX[\"create_docx\"] ~~~ PPTX[\"create_pptx\"]\n end\n subgraph Deliver[\"🐝 LINE Hive\"]\n direction LR\n Ask[\"line_ask\"] ~~~ Status[\"line_set_status\"]\n end\n Agent[\"🤖 Agent\"] --> Generate\n Generate -.-> File[\"💾 Files\"]\n File -.-> Deliver\n Agent --> Deliver\n Deliver --> Phone[\"📱 LINE\"]\n\n style Generate fill:#e3f2fd,stroke:#1565c0\n style Deliver fill:#f3e5f5,stroke:#7b1fa2\n classDef output fill:#e8f5e9,stroke:#2e7d32\n class Phone output\n```\n\nDoc Hive is a standalone MCP server — use it with or without LINE Hive. Install both for the full pipeline:\n\n```bash\nnpx @zoulabo/line-hive init # LINE messaging\nnpx doc-hive init # Document generation\n```\n\nSee the [Doc Hive README](../doc-hive/README.md) for full documentation.\n\n## Quick Start\n\n```bash\nnpx @zoulabo/line-hive init # Interactive setup\n# Restart your editor — MCP server starts automatically\n```\n\nYou'll need a [LINE Official Account](#1-create-a-line-official-account) and a [webhook tunnel](#2-set-up-a-webhook-tunnel) first. Optionally verify your connection:\n```bash\nnpx @zoulabo/line-hive test\n```\n\n## How It Works\n\nAgents report status. You check from LINE when *you* want. No push spam — all status replies use LINE's free replyToken.\n\n```mermaid\nsequenceDiagram\n participant You as 📱 You\n participant Hive as 🐝 LINE Hive\n participant Agent as 🤖 Agent\n\n Agent->>Hive: set_status(\"running tests\")\n Note over Agent: keeps working...\n\n You->>Hive: ?\n Hive-->>You: 🟡 Running tests\n\n Agent->>Hive: ask(\"3 tests failed. Fix?\")\n You->>Hive: ?\n Hive-->>You: 🔴 3 tests failed. Fix?\n You->>Hive: yes, fix them\n Hive->>Agent: \"yes, fix them\"\n\n Agent->>Hive: set_status(\"applying fixes\")\n Note over Agent: done\n Agent->>Hive: set_status(idle)\n```\n\n**Key concepts:**\n- **Pull, not push** — agents set status, you check with `?` when convenient\n- **Free** — status queries use LINE replyTokens, not push quota\n- **Multi-agent** — multiple editors share one bot; select by number\n- **Conversational** — `line_ask` blocks until you reply, then returns your answer to the agent\n\n## Prerequisites\n\n- A [LINE Official Account](#1-create-a-line-official-account) with Messaging API enabled\n- A [webhook tunnel](#2-set-up-a-webhook-tunnel) to localhost:19780 (ngrok recommended)\n- Node.js 18+\n\n## Setup\n\n### 1. Create a LINE Official Account\n\n> ~5 minutes. Needs a browser + LINE app.\n\n1. [LINE Developers Console](https://developers.line.biz/console/) → Create **Provider** → Create **Messaging API** channel\n2. Copy **Channel Secret** (*Basic settings*) and **Channel Access Token** (*Messaging API* → *Issue*)\n3. Add the bot as a friend (scan QR in *Messaging API* → *Bot information*)\n4. Disable auto-reply: *Messaging API* → *Auto-reply messages* → *Edit* → turn off both\n\n> **Webhook URL** — set after configuring your tunnel. Format: `https://YOUR-TUNNEL/webhook`\n\n### 2. Set Up a Webhook Tunnel\n\nLINE needs a public HTTPS URL. **ngrok** is recommended — the MCP server auto-manages it.\n\n1. Sign up at [ngrok.com](https://ngrok.com/) (free tier works) and install:\n ```bash\n brew install ngrok # macOS\n ngrok config add-authtoken YOUR_AUTH_TOKEN # authenticate\n ```\n2. **Claim a free stable domain** at [dashboard.ngrok.com/domains](https://dashboard.ngrok.com/domains) → *Create Domain*\n3. In [LINE Developers Console](https://developers.line.biz/console/) → *Messaging API* → set **Webhook URL** to `https://YOUR-DOMAIN.ngrok-free.dev/webhook` → toggle **Use webhook** On\n\n