better-tg-cli 0.39.3 → 0.39.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.es.md CHANGED
@@ -11,7 +11,7 @@
11
11
  [![install size](https://img.shields.io/npm/unpacked-size/better-tg-cli?label=size&style=flat&colorA=000000&colorB=000000)](https://www.npmjs.com/package/better-tg-cli)
12
12
  [![dependencies](https://img.shields.io/badge/dependencies-0-000000?style=flat&colorA=000000&colorB=000000)](package.json)
13
13
  [![MCP](https://img.shields.io/badge/MCP-server-000000?style=flat&colorA=000000&colorB=000000)](#servidor-mcp)
14
- [![platforms](https://img.shields.io/badge/macOS%20%C2%B7%20Linux-000000?style=flat&colorA=000000&colorB=000000&logo=apple)](#instalación)
14
+ [![platforms](https://img.shields.io/badge/macOS%20%C2%B7%20Linux%20%C2%B7%20Windows-000000?style=flat&colorA=000000&colorB=000000)](#instalación)
15
15
  [![license](https://img.shields.io/badge/license-MIT-000000?style=flat&colorA=000000&colorB=000000)](LICENSE)
16
16
 
17
17
  <p>
@@ -21,10 +21,14 @@
21
21
 
22
22
  https://github.com/user-attachments/assets/d143f7c7-7d50-439c-b373-cbcbff5a6675
23
23
 
24
- Un cliente de línea de comandos no oficial para Telegram, pensado para agentes, que funciona **con tu
25
- propia cuenta** (MTProto mediante [`teleproto`](https://www.npmjs.com/package/teleproto), TL layer 229).
26
- El comando es `telegram`: unos 60 comandos para leer, buscar, escribir, bots, grupos y exportaciones,
27
- diseñados para que los agentes de IA (Claude Code, Codex, …) puedan manejarlo de forma barata y segura.
24
+ **Better-TG-CLI es un CLI y servidor MCP de Telegram para agentes de IA** (Claude Code, Codex,
25
+ Cursor, Claude Desktop, Gemini CLI) que funciona con tu propia cuenta de Telegram: los agentes leen,
26
+ buscan y envían mensajes y pulsan botones de bots, y tú apruebas cada envío.
27
+
28
+ Es un cliente no oficial y de código abierto (MTProto mediante [`teleproto`](https://www.npmjs.com/package/teleproto),
29
+ TL layer 229). El comando es `telegram`: unos 60 comandos para leer, buscar, escribir, bots, grupos y
30
+ exportaciones, diseñados para que los agentes lo manejen de forma barata y segura. También viene como
31
+ servidor MCP (`telegram mcp`) y como skill para agentes.
28
32
 
29
33
  ```console
30
34
  $ telegram inbox -n 3
@@ -44,11 +48,11 @@ $ telegram read @alice -n 1 --json
44
48
  > [SECURITY.md](SECURITY.md) antes de dejar que un agente escriba. Los autores no se hacen
45
49
  > responsables de las cuentas restringidas.
46
50
 
47
- **Contenido:** [Por qué este fork](#por-qué-este-fork) · [Instalación](#instalación) · [Inicio de sesión](#inicio-de-sesión) · [Uso](#uso) · [Servidor MCP](#servidor-mcp) · [FAQ](#faq) · [Desarrollo](#desarrollo) · [Privacidad](#privacidad) · [Licencia](#licencia)
51
+ **Contenido:** [Por qué Better-TG-CLI](#por-qué-better-tg-cli) · [Instalación](#instalación) · [Inicio de sesión](#inicio-de-sesión) · [Uso](#uso) · [Servidor MCP](#servidor-mcp) · [FAQ](#faq) · [Desarrollo](#desarrollo) · [Privacidad](#privacidad) · [Licencia](#licencia)
48
52
 
49
- ## Por qué este fork
53
+ ## Por qué Better-TG-CLI
50
54
 
51
- Un fork de [skillhq/telegram](https://github.com/skillhq/telegram), rehecho para agentes:
55
+ Hecho para agentes:
52
56
 
53
57
  - **Capa de Telegram actual.** Las respuestas de bots con contenido enriquecido (layer 228+) muestran
54
58
  el texto real en lugar de `(no text)`. Puedes pulsar botones de bots (`click`) y recorrer sus menús.
@@ -66,6 +70,23 @@ Un fork de [skillhq/telegram](https://github.com/skillhq/telegram), rehecho para
66
70
  - **Pequeño y autónomo.** El paquete de npm es un único archivo de 0,3 MB sin dependencias en tiempo
67
71
  de ejecución. Homebrew instala un binario independiente que no necesita Node.
68
72
 
73
+ Empezó como un fork de [skillhq/telegram](https://github.com/skillhq/telegram) y desde entonces se
74
+ ha rehecho por completo.
75
+
76
+ ### Comparación con otros servidores MCP de Telegram
77
+
78
+ | | Better-TG-CLI | [chigwell/telegram-mcp](https://github.com/chigwell/telegram-mcp) | [chaindead/telegram-mcp](https://github.com/chaindead/telegram-mcp) | [WireCatLabs/tg-cli](https://github.com/WireCatLabs/tg-cli) |
79
+ |---|---|---|---|---|
80
+ | Qué incluye | CLI, servidor MCP, skill | servidor MCP | servidor MCP | CLI, servidor MCP, skill |
81
+ | Lenguaje | TypeScript (Node 20+ o un binario independiente) | Python | Go | TypeScript |
82
+ | Biblioteca de Telegram | teleproto (fork de GramJS, layer 229) | Telethon | gotd/td | mtcute |
83
+ | Dependencias en ejecución | ninguna (un archivo) | paquetes de Python | un binario de Go | paquetes de npm |
84
+ | Instalación | Homebrew, Scoop, npm, binarios | pip, uvx, Docker | Homebrew, npx, go install | npm, bun |
85
+
86
+ Datos tomados del README y el manifiesto de cada proyecto en noviembre de 2026; abre un issue si algo
87
+ está desactualizado. Lo que distingue a Better-TG-CLI es el modelo de escritura (solo lectura, ask,
88
+ on, con aprobaciones ligadas al texto exacto) y una salida pensada para agentes.
89
+
69
90
  ## Instalación
70
91
 
71
92
  ```bash
@@ -100,7 +121,7 @@ Todos los canales distribuyen la misma versión desde una única release:
100
121
  | [npm](https://www.npmjs.com/package/better-tg-cli) | CLI y servidor MCP (Node 20+) | `npm install -g better-tg-cli` |
101
122
  | [Scoop](https://github.com/TheVilfer/scoop-bucket) (Windows, experimental) | `telegram.exe` independiente | `scoop bucket add thevilfer https://github.com/TheVilfer/scoop-bucket` y luego `scoop install better-tg-cli` |
102
123
  | [GitHub Releases](https://github.com/TheVilfer/better-tg-cli/releases) | binarios y SHA256SUMS | descarga manual |
103
- | Plugin de Claude Code | skill y servidor MCP | [ver abajo](#plugin-para-claude-code) |
124
+ | Plugin de Claude Code | skill (usa la CLI instalada) | [ver abajo](#plugin-para-claude-code) |
104
125
  | Extensión de Claude Desktop | servidor MCP, se ejecuta con el Node integrado de Claude | [descarga el `.mcpb`](https://github.com/TheVilfer/better-tg-cli/releases/latest/download/better-tg-cli.mcpb) y ábrelo |
105
126
  | Plugin de Grok Build | skill y servidor MCP | [ver abajo](#plugin-para-grok-build) |
106
127
  | Extensión de Gemini CLI | skill y servidor MCP | `gemini extensions install https://github.com/TheVilfer/better-tg-cli` |
@@ -112,20 +133,22 @@ Todos los canales distribuyen la misma versión desde una única release:
112
133
 
113
134
  ### Plugin para Claude Code
114
135
 
115
- La skill y el servidor MCP juntos, en una sola instalación:
136
+ La skill como plugin, que Claude Code mantiene al día:
116
137
 
117
138
  ```
118
139
  /plugin marketplace add TheVilfer/better-tg-cli
119
140
  /plugin install better-tg-cli@better-tg-cli
120
141
  ```
121
142
 
122
- Ejecuta su propia copia del servidor MCP, incluida en el plugin, así que basta con Node 20+ y no se
123
- descarga nada al instalar. Inicia sesión una vez con
124
- `telegram auth --qr` (o `npx better-tg-cli auth --qr`) en un terminal.
143
+ El plugin es solo la skill: instala antes la CLI (arriba) e inicia sesión una vez con
144
+ `telegram onboard` en un terminal. Después Claude Code ejecuta `telegram` por su cuenta. El directorio
145
+ de plugins de Anthropic solo acepta servidores MCP que se ejecutan en tu ordenador si vienen de
146
+ organizaciones Verified, así que el servidor MCP se añade aparte si lo quieres:
147
+ `claude mcp add telegram -- telegram mcp`.
125
148
 
126
149
  ### Plugin para Codex
127
150
 
128
- La misma skill y el mismo servidor MCP como plugin de Codex (también aparece en la app de escritorio
151
+ La skill y el servidor MCP como plugin de Codex (también aparece en la app de escritorio
129
152
  de ChatGPT):
130
153
 
131
154
  ```bash
@@ -135,7 +158,7 @@ codex plugin add better-tg-cli@better-tg-cli
135
158
 
136
159
  ### Plugin para Grok Build
137
160
 
138
- [Grok Build](https://x.ai/cli) instala el mismo plugin, con la skill y el servidor MCP juntos:
161
+ [Grok Build](https://x.ai/cli) instala el plugin con la skill y el servidor MCP juntos:
139
162
 
140
163
  ```bash
141
164
  grok plugin install TheVilfer/better-tg-cli --trust
package/README.md CHANGED
@@ -11,7 +11,7 @@
11
11
  [![install size](https://img.shields.io/npm/unpacked-size/better-tg-cli?label=size&style=flat&colorA=000000&colorB=000000)](https://www.npmjs.com/package/better-tg-cli)
12
12
  [![dependencies](https://img.shields.io/badge/dependencies-0-000000?style=flat&colorA=000000&colorB=000000)](package.json)
13
13
  [![MCP](https://img.shields.io/badge/MCP-server-000000?style=flat&colorA=000000&colorB=000000)](#mcp-server)
14
- [![platforms](https://img.shields.io/badge/macOS%20%C2%B7%20Linux-000000?style=flat&colorA=000000&colorB=000000&logo=apple)](#install)
14
+ [![platforms](https://img.shields.io/badge/macOS%20%C2%B7%20Linux%20%C2%B7%20Windows-000000?style=flat&colorA=000000&colorB=000000)](#install)
15
15
  [![license](https://img.shields.io/badge/license-MIT-000000?style=flat&colorA=000000&colorB=000000)](LICENSE)
16
16
 
17
17
  <p>
@@ -21,10 +21,14 @@
21
21
 
22
22
  https://github.com/user-attachments/assets/d143f7c7-7d50-439c-b373-cbcbff5a6675
23
23
 
24
- An unofficial, agent-friendly command-line client for Telegram that runs **on your own account**
25
- (MTProto via [`teleproto`](https://www.npmjs.com/package/teleproto), TL layer 229). The command is
26
- `telegram`: about 60 commands for reading, searching, writing, bots, groups and exports, built so
27
- that AI agents (Claude Code, Codex, …) can drive it cheaply and safely.
24
+ **Better-TG-CLI is a Telegram CLI and MCP server for AI agents** (Claude Code, Codex, Cursor,
25
+ Claude Desktop, Gemini CLI) that works on your own Telegram account: agents read, search and send
26
+ messages and press bot buttons, and you approve every send.
27
+
28
+ It is an unofficial, open-source client (MTProto via [`teleproto`](https://www.npmjs.com/package/teleproto),
29
+ TL layer 229). The command is `telegram`: about 60 commands for reading, searching, writing, bots,
30
+ groups and exports, built so that agents can drive it cheaply and safely. It also ships as an MCP
31
+ server (`telegram mcp`) and an agent skill.
28
32
 
29
33
  ```console
30
34
  $ telegram inbox -n 3
@@ -43,11 +47,11 @@ $ telegram read @alice -n 1 --json
43
47
  > use Telegram yourself, keep writes off unless you need them, and read [SECURITY.md](SECURITY.md)
44
48
  > before letting an agent write. The authors are not responsible for restricted accounts.
45
49
 
46
- **Contents:** [Why this fork](#why-this-fork) · [Install](#install) · [Log in](#log-in) · [Usage](#usage) · [MCP server](#mcp-server) · [FAQ](#faq) · [Development](#development) · [Privacy](#privacy) · [License](#license)
50
+ **Contents:** [Why Better-TG-CLI](#why-better-tg-cli) · [Install](#install) · [Log in](#log-in) · [Usage](#usage) · [MCP server](#mcp-server) · [FAQ](#faq) · [Development](#development) · [Privacy](#privacy) · [License](#license)
47
51
 
48
- ## Why this fork
52
+ ## Why Better-TG-CLI
49
53
 
50
- A fork of [skillhq/telegram](https://github.com/skillhq/telegram), reworked for agents:
54
+ Made for agents:
51
55
 
52
56
  - **Current Telegram layer.** Bot replies with rich (layer 228+) content show real text instead of
53
57
  `(no text)`. You can press bot buttons (`click`) and walk bot menus.
@@ -65,6 +69,23 @@ A fork of [skillhq/telegram](https://github.com/skillhq/telegram), reworked for
65
69
  - **Small and self-contained.** The npm package is one 0.3 MB file with zero runtime
66
70
  dependencies. Homebrew installs a standalone binary with no Node.
67
71
 
72
+ It started as a fork of [skillhq/telegram](https://github.com/skillhq/telegram) and has since been
73
+ reworked throughout.
74
+
75
+ ### Compared with other Telegram MCP servers
76
+
77
+ | | Better-TG-CLI | [chigwell/telegram-mcp](https://github.com/chigwell/telegram-mcp) | [chaindead/telegram-mcp](https://github.com/chaindead/telegram-mcp) | [WireCatLabs/tg-cli](https://github.com/WireCatLabs/tg-cli) |
78
+ |---|---|---|---|---|
79
+ | What you get | CLI, MCP server, agent skill | MCP server | MCP server | CLI, MCP server, agent skill |
80
+ | Language | TypeScript (Node 20+ or a standalone binary) | Python | Go | TypeScript |
81
+ | Telegram library | teleproto (GramJS fork, layer 229) | Telethon | gotd/td | mtcute |
82
+ | Runtime dependencies | none (one file) | Python packages | one Go binary | npm packages |
83
+ | Install | Homebrew, Scoop, npm, binaries | pip, uvx, Docker | Homebrew, npx, go install | npm, bun |
84
+
85
+ Taken from each project's README and manifest in November 2026; open an issue if something here is
86
+ out of date. What sets Better-TG-CLI apart is the write model (read-only, ask, on, with approvals
87
+ bound to the exact text) and output made for agents.
88
+
68
89
  ## Install
69
90
 
70
91
  ```bash
@@ -98,7 +119,7 @@ Every channel ships the same version from one release:
98
119
  | [npm](https://www.npmjs.com/package/better-tg-cli) | CLI and MCP server (Node 20+) | `npm install -g better-tg-cli` |
99
120
  | [Scoop](https://github.com/TheVilfer/scoop-bucket) (Windows, experimental) | standalone `telegram.exe` | `scoop bucket add thevilfer https://github.com/TheVilfer/scoop-bucket` then `scoop install better-tg-cli` |
100
121
  | [GitHub Releases](https://github.com/TheVilfer/better-tg-cli/releases) | binaries and SHA256SUMS | download by hand |
101
- | Claude Code plugin | skill and MCP server | [see below](#claude-code-plugin) |
122
+ | Claude Code plugin | skill (uses the installed CLI) | [see below](#claude-code-plugin) |
102
123
  | 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 |
103
124
  | Grok Build plugin | skill and MCP server | [see below](#grok-build-plugin) |
104
125
  | Gemini CLI extension | skill and MCP server | `gemini extensions install https://github.com/TheVilfer/better-tg-cli` |
@@ -110,20 +131,21 @@ Every channel ships the same version from one release:
110
131
 
111
132
  ### Claude Code plugin
112
133
 
113
- The skill and the MCP server together, in one install:
134
+ The skill as a plugin, kept up to date by Claude Code:
114
135
 
115
136
  ```
116
137
  /plugin marketplace add TheVilfer/better-tg-cli
117
138
  /plugin install better-tg-cli@better-tg-cli
118
139
  ```
119
140
 
120
- It runs its own copy of the MCP server, included in the plugin, so Node 20+ is enough and nothing
121
- is downloaded at install time. Log in once with `telegram auth --qr`
122
- (or `npx better-tg-cli auth --qr`) in a terminal.
141
+ The plugin is the skill alone, so install the CLI first (above) and log in once with
142
+ `telegram onboard` in a terminal. Claude Code then runs `telegram` itself. Anthropic's plugin
143
+ directory accepts MCP servers that run on your computer only from Verified organizations, so the MCP
144
+ server is added on its own if you want it: `claude mcp add telegram -- telegram mcp`.
123
145
 
124
146
  ### Codex plugin
125
147
 
126
- The same skill and MCP server as a Codex plugin (also shows up in the ChatGPT desktop app):
148
+ The skill and the MCP server as a Codex plugin (also shows up in the ChatGPT desktop app):
127
149
 
128
150
  ```bash
129
151
  codex plugin marketplace add TheVilfer/better-tg-cli
@@ -132,7 +154,7 @@ codex plugin add better-tg-cli@better-tg-cli
132
154
 
133
155
  ### Grok Build plugin
134
156
 
135
- [Grok Build](https://x.ai/cli) installs the same plugin, skill and MCP server together:
157
+ [Grok Build](https://x.ai/cli) installs the plugin with the skill and the MCP server together:
136
158
 
137
159
  ```bash
138
160
  grok plugin install TheVilfer/better-tg-cli --trust
package/README.ru.md CHANGED
@@ -11,7 +11,7 @@
11
11
  [![install size](https://img.shields.io/npm/unpacked-size/better-tg-cli?label=size&style=flat&colorA=000000&colorB=000000)](https://www.npmjs.com/package/better-tg-cli)
12
12
  [![dependencies](https://img.shields.io/badge/dependencies-0-000000?style=flat&colorA=000000&colorB=000000)](package.json)
13
13
  [![MCP](https://img.shields.io/badge/MCP-server-000000?style=flat&colorA=000000&colorB=000000)](#mcp-сервер)
14
- [![platforms](https://img.shields.io/badge/macOS%20%C2%B7%20Linux-000000?style=flat&colorA=000000&colorB=000000&logo=apple)](#установка)
14
+ [![platforms](https://img.shields.io/badge/macOS%20%C2%B7%20Linux%20%C2%B7%20Windows-000000?style=flat&colorA=000000&colorB=000000)](#установка)
15
15
  [![license](https://img.shields.io/badge/license-MIT-000000?style=flat&colorA=000000&colorB=000000)](LICENSE)
16
16
 
17
17
  <p>
@@ -21,10 +21,14 @@
21
21
 
22
22
  https://github.com/user-attachments/assets/d143f7c7-7d50-439c-b373-cbcbff5a6675
23
23
 
24
- Неофициальный консольный клиент Telegram, который работает **от вашего собственного аккаунта**
25
- (MTProto через [`teleproto`](https://www.npmjs.com/package/teleproto), TL layer 229). Команда
26
- называется `telegram`. В ней около 60 команд: чтение, поиск, отправка, боты, группы, выгрузка. Всё
27
- сделано так, чтобы им было дёшево и безопасно пользоваться ИИ-агентам (Claude Code, Codex и другим).
24
+ **Better-TG-CLI — это CLI и MCP-сервер Telegram для ИИ-агентов** (Claude Code, Codex, Cursor,
25
+ Claude Desktop, Gemini CLI), который работает от вашего собственного аккаунта: агенты читают, ищут и
26
+ отправляют сообщения, нажимают кнопки ботов, а каждую отправку подтверждаете вы.
27
+
28
+ Это неофициальный клиент с открытым кодом (MTProto через [`teleproto`](https://www.npmjs.com/package/teleproto),
29
+ TL layer 229). Команда называется `telegram`. В ней около 60 команд: чтение, поиск, отправка, боты,
30
+ группы, выгрузка, и всё сделано так, чтобы агентам было дёшево и безопасно ими пользоваться. Есть и
31
+ MCP-сервер (`telegram mcp`), и скилл для агентов.
28
32
 
29
33
  ```console
30
34
  $ telegram inbox -n 3
@@ -42,11 +46,11 @@ $ telegram inbox -n 3
42
46
  > она не нужна. Прежде чем разрешать агенту писать, прочитайте [SECURITY.md](SECURITY.md). Авторы
43
47
  > не отвечают за ограниченные аккаунты.
44
48
 
45
- **Содержание:** [Чем этот форк лучше](#чем-этот-форк-лучше) · [Установка](#установка) · [Вход](#вход) · [Использование](#использование) · [MCP-сервер](#mcp-сервер) · [FAQ](#faq) · [Разработка](#разработка) · [Приватность](#приватность) · [Лицензия](#лицензия)
49
+ **Содержание:** [Чем хорош Better-TG-CLI](#чем-хорош-better-tg-cli) · [Установка](#установка) · [Вход](#вход) · [Использование](#использование) · [MCP-сервер](#mcp-сервер) · [FAQ](#faq) · [Разработка](#разработка) · [Приватность](#приватность) · [Лицензия](#лицензия)
46
50
 
47
- ## Чем этот форк лучше
51
+ ## Чем хорош Better-TG-CLI
48
52
 
49
- Это форк [skillhq/telegram](https://github.com/skillhq/telegram), переделанный под агентов:
53
+ Сделан для агентов:
50
54
 
51
55
  - **Актуальный слой Telegram.** Ответы ботов с rich-контентом (layer 228+) показывают текст, а не
52
56
  `(no text)`. Можно нажимать кнопки ботов (`click`) и ходить по их меню.
@@ -64,6 +68,23 @@ $ telegram inbox -n 3
64
68
  - **Маленький и самодостаточный.** npm-пакет — один файл на 0,3 МБ без runtime-зависимостей.
65
69
  Homebrew ставит отдельный бинарник, которому не нужен Node.
66
70
 
71
+ Проект начинался как форк [skillhq/telegram](https://github.com/skillhq/telegram) и с тех пор
72
+ переделан целиком.
73
+
74
+ ### Сравнение с другими MCP-серверами для Telegram
75
+
76
+ | | Better-TG-CLI | [chigwell/telegram-mcp](https://github.com/chigwell/telegram-mcp) | [chaindead/telegram-mcp](https://github.com/chaindead/telegram-mcp) | [WireCatLabs/tg-cli](https://github.com/WireCatLabs/tg-cli) |
77
+ |---|---|---|---|---|
78
+ | Что внутри | CLI, MCP-сервер, скилл | MCP-сервер | MCP-сервер | CLI, MCP-сервер, скилл |
79
+ | Язык | TypeScript (Node 20+ или отдельный бинарник) | Python | Go | TypeScript |
80
+ | Библиотека Telegram | teleproto (форк GramJS, layer 229) | Telethon | gotd/td | mtcute |
81
+ | Зависимости при запуске | нет (один файл) | пакеты Python | один бинарник Go | пакеты npm |
82
+ | Установка | Homebrew, Scoop, npm, бинарники | pip, uvx, Docker | Homebrew, npx, go install | npm, bun |
83
+
84
+ Данные взяты из README и манифестов проектов в ноябре 2026 года; если что-то устарело, откройте
85
+ issue. Better-TG-CLI отличает модель записи (только чтение, ask, on, подтверждение привязано к точному
86
+ тексту) и вывод, сделанный для агентов.
87
+
67
88
  ## Установка
68
89
 
69
90
  ```bash
@@ -97,7 +118,7 @@ scoop install better-tg-cli
97
118
  | [npm](https://www.npmjs.com/package/better-tg-cli) | CLI и MCP-сервер (Node 20+) | `npm install -g better-tg-cli` |
98
119
  | [Scoop](https://github.com/TheVilfer/scoop-bucket) (Windows, экспериментально) | отдельный `telegram.exe` | `scoop bucket add thevilfer https://github.com/TheVilfer/scoop-bucket`, затем `scoop install better-tg-cli` |
99
120
  | [GitHub Releases](https://github.com/TheVilfer/better-tg-cli/releases) | бинарники и SHA256SUMS | скачать вручную |
100
- | Плагин Claude Code | скилл и MCP-сервер | [см. ниже](#плагин-для-claude-code) |
121
+ | Плагин Claude Code | скилл (работает через установленный CLI) | [см. ниже](#плагин-для-claude-code) |
101
122
  | Расширение Claude Desktop | MCP-сервер на встроенном Node из Claude | [скачать `.mcpb`](https://github.com/TheVilfer/better-tg-cli/releases/latest/download/better-tg-cli.mcpb) и открыть |
102
123
  | Плагин Grok Build | скилл и MCP-сервер | [см. ниже](#плагин-для-grok-build) |
103
124
  | Расширение Gemini CLI | скилл и MCP-сервер | `gemini extensions install https://github.com/TheVilfer/better-tg-cli` |
@@ -109,20 +130,21 @@ scoop install better-tg-cli
109
130
 
110
131
  ### Плагин для Claude Code
111
132
 
112
- Скилл и MCP-сервер ставятся вместе:
133
+ Скилл в виде плагина, который Claude Code обновляет сам:
113
134
 
114
135
  ```
115
136
  /plugin marketplace add TheVilfer/better-tg-cli
116
137
  /plugin install better-tg-cli@better-tg-cli
117
138
  ```
118
139
 
119
- Плагин запускает собственную копию MCP-сервера, которая лежит в нём самом, так что хватит Node 20+,
120
- и при установке ничего не скачивается. Один раз войдите в терминале:
121
- `telegram auth --qr` (или `npx better-tg-cli auth --qr`).
140
+ В плагине только скилл, поэтому сначала установите CLI (см. выше) и один раз войдите в терминале
141
+ через `telegram onboard`. Дальше Claude Code сам запускает `telegram`. Каталог плагинов Anthropic
142
+ принимает MCP-серверы, которые работают на вашем компьютере, только от Verified-организаций, поэтому
143
+ MCP-сервер, если он нужен, добавляется отдельно: `claude mcp add telegram -- telegram mcp`.
122
144
 
123
145
  ### Плагин для Codex
124
146
 
125
- Тот же скилл и MCP-сервер в виде плагина Codex (он появится и в десктопном приложении ChatGPT):
147
+ Скилл и MCP-сервер в виде плагина Codex (он появится и в десктопном приложении ChatGPT):
126
148
 
127
149
  ```bash
128
150
  codex plugin marketplace add TheVilfer/better-tg-cli
@@ -131,7 +153,7 @@ codex plugin add better-tg-cli@better-tg-cli
131
153
 
132
154
  ### Плагин для Grok Build
133
155
 
134
- [Grok Build](https://x.ai/cli) ставит тот же плагин, скилл и MCP-сервер вместе:
156
+ [Grok Build](https://x.ai/cli) ставит плагин, скилл и MCP-сервер вместе:
135
157
 
136
158
  ```bash
137
159
  grok plugin install TheVilfer/better-tg-cli --trust