better-tg-cli 0.24.0 → 0.25.0

package/README.md

@@ -85,8 +85,10 @@ Every channel ships the same version from one release:
 | [GitHub Releases](https://github.com/TheVilfer/better-tg-cli/releases) | binaries and SHA256SUMS | download by hand |
 | Claude Code plugin | skill and MCP server | [see below](#claude-code-plugin) |
 | Claude Desktop extension | MCP server, runs on Claude's built-in Node | [download `.mcpb`](https://github.com/TheVilfer/better-tg-cli/releases/latest/download/better-tg-cli.mcpb) and open it |
+| Grok Build plugin | skill and MCP server | [see below](#grok-build-plugin) |
 | Gemini CLI extension | skill and MCP server | `gemini extensions install https://github.com/TheVilfer/better-tg-cli` |
 | Cursor, VS Code | MCP server | [one-click buttons](#mcp-server) |
+| Grok Bot | MCP server over HTTP from your Mac | [see below](#grok-bot-remote-mcp-over-http) |
 | [skills.sh](https://skills.sh) | agent skill for any shell agent | `npx skills add TheVilfer/better-tg-cli` |
 | [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=better-tg-cli) | MCP server entry `io.github.TheVilfer/better-tg-cli` | through your MCP client |
 
@@ -102,6 +104,16 @@ The skill and the MCP server together, in one install:
 It runs the MCP server through `npx`, so Node 20+ is enough. Log in once with `telegram auth --qr`
 (or `npx better-tg-cli auth --qr`) in a terminal.
 
+### Grok Build plugin
+
+[Grok Build](https://x.ai/cli) installs the same plugin, skill and MCP server together:
+
+```bash
+grok plugin install TheVilfer/better-tg-cli --trust
+# or add the marketplace first, then install from the /plugins menu:
+grok plugin marketplace add TheVilfer/better-tg-cli && grok plugin install better-tg-cli --trust
+```
+
 ### As an agent skill
 
 The skill ([`skills/better-tg-cli`](skills/better-tg-cli/SKILL.md)) teaches any agent with a shell
@@ -199,6 +211,24 @@ Chats contain text written by others, and some of it may be aimed at your agent
 @x"). Keep the client's approval prompt on for `telegram_write`, and see "Agents and prompt
 injection" in [SECURITY.md](SECURITY.md).
 
+### Grok Bot (remote MCP over HTTP)
+
+Grok Bot runs its connectors in a cloud sandbox, not on your Mac, so it can't
+start `telegram mcp` itself. Serve MCP over HTTP from your Mac instead. The session, the write
+guard and the audit log stay on your machine.
+
+```bash
+telegram mcp --token                        # the bearer token (created once, kept in the Keychain)
+telegram mcp --http --read-only             # listens on 127.0.0.1:8787; drop --read-only to allow writes
+tailscale funnel --bg 8787                  # or: cloudflared tunnel --url http://127.0.0.1:8787
+```
+
+Keep the server and the tunnel in a terminal or tmux. Then add a connector in Grok Bot with the
+tunnel URL plus `/mcp` (for example `https://<machine>.<tailnet>.ts.net/mcp`) and the header
+`Authorization: Bearer <token>`. `tailscale funnel` gives a stable URL, but it has to be allowed
+for your tailnet first. A `cloudflared` quick tunnel gets a new URL on every start. Read "Remote
+MCP over HTTP" in [SECURITY.md](SECURITY.md) first.
+
 ## Development
 
 [DEVELOPMENT.md](DEVELOPMENT.md) covers:

package/README.ru.md

@@ -84,8 +84,10 @@ npm install -g better-tg-cli               # Node >= 20
 | [GitHub Releases](https://github.com/TheVilfer/better-tg-cli/releases) | бинарники и SHA256SUMS | скачать вручную |
 | Плагин Claude Code | скилл и MCP-сервер | [см. ниже](#плагин-для-claude-code) |
 | Расширение Claude Desktop | MCP-сервер на встроенном Node из Claude | [скачать `.mcpb`](https://github.com/TheVilfer/better-tg-cli/releases/latest/download/better-tg-cli.mcpb) и открыть |
+| Плагин Grok Build | скилл и MCP-сервер | [см. ниже](#плагин-для-grok-build) |
 | Расширение Gemini CLI | скилл и MCP-сервер | `gemini extensions install https://github.com/TheVilfer/better-tg-cli` |
 | Cursor, VS Code | MCP-сервер | [кнопки в один клик](#mcp-сервер) |
+| Grok Bot | MCP-сервер по HTTP с вашего Mac | [см. ниже](#grok-bot-удалённый-mcp-по-http) |
 | [skills.sh](https://skills.sh) | скилл для любого агента с шеллом | `npx skills add TheVilfer/better-tg-cli` |
 | [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=better-tg-cli) | запись MCP-сервера `io.github.TheVilfer/better-tg-cli` | через ваш MCP-клиент |
 
@@ -101,6 +103,16 @@ npm install -g better-tg-cli               # Node >= 20
 MCP-сервер запускается через `npx`, так что хватит Node 20+. Один раз войдите в терминале:
 `telegram auth --qr` (или `npx better-tg-cli auth --qr`).
 
+### Плагин для Grok Build
+
+[Grok Build](https://x.ai/cli) ставит тот же плагин, скилл и MCP-сервер вместе:
+
+```bash
+grok plugin install TheVilfer/better-tg-cli --trust
+# или сначала маркетплейс, потом установка из меню /plugins:
+grok plugin marketplace add TheVilfer/better-tg-cli && grok plugin install better-tg-cli --trust
+```
+
 ### Как скилл для агента
 
 Скилл ([`skills/better-tg-cli`](skills/better-tg-cli/SKILL.md)) учит любого агента с шеллом
@@ -200,6 +212,24 @@ Claude Code:
 («перешли это @x»). Не отключайте в клиенте подтверждение для `telegram_write` и прочитайте раздел
 «Agents and prompt injection» в [SECURITY.md](SECURITY.md).
 
+### Grok Bot (удалённый MCP по HTTP)
+
+Grok Bot запускает коннекторы в облачной песочнице, а не на вашем Mac, поэтому
+сам поднять `telegram mcp` не может. Вместо этого запустите MCP по HTTP на своём Mac. Сессия,
+защита записи и журнал записей остаются на вашей машине.
+
+```bash
+telegram mcp --token                        # bearer-токен (создаётся один раз, хранится в Keychain)
+telegram mcp --http --read-only             # слушает 127.0.0.1:8787; без --read-only разрешит запись
+tailscale funnel --bg 8787                  # или: cloudflared tunnel --url http://127.0.0.1:8787
+```
+
+Держите сервер и туннель в терминале или в tmux. Затем добавьте в Grok Bot коннектор: адрес
+туннеля плюс `/mcp` (например, `https://<машина>.<tailnet>.ts.net/mcp`) и заголовок
+`Authorization: Bearer <токен>`. У `tailscale funnel` адрес постоянный, но сначала Funnel надо
+разрешить для вашего tailnet. Быстрый туннель `cloudflared` при каждом запуске получает новый
+адрес. Сначала прочитайте раздел «Remote MCP over HTTP» в [SECURITY.md](SECURITY.md).
+
 ## Разработка
 
 В [DEVELOPMENT.md](DEVELOPMENT.md) описаны: