better-tg-cli 0.39.4 → 0.39.6
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 +29 -8
- package/README.md +29 -8
- package/README.ru.md +29 -8
- package/dist/telegram.mjs +1 -1
- package/package.json +6 -3
package/README.es.md
CHANGED
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
[](https://www.npmjs.com/package/better-tg-cli)
|
|
12
12
|
[](package.json)
|
|
13
13
|
[](#servidor-mcp)
|
|
14
|
-
[](#instalación)
|
|
15
15
|
[](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
|
-
|
|
25
|
-
propia cuenta
|
|
26
|
-
|
|
27
|
-
|
|
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é
|
|
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é
|
|
53
|
+
## Por qué Better-TG-CLI
|
|
50
54
|
|
|
51
|
-
|
|
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
|
package/README.md
CHANGED
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
[](https://www.npmjs.com/package/better-tg-cli)
|
|
12
12
|
[](package.json)
|
|
13
13
|
[](#mcp-server)
|
|
14
|
-
[](#install)
|
|
15
15
|
[](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
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
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
|
|
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
|
|
52
|
+
## Why Better-TG-CLI
|
|
49
53
|
|
|
50
|
-
|
|
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
|
package/README.ru.md
CHANGED
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
[](https://www.npmjs.com/package/better-tg-cli)
|
|
12
12
|
[](package.json)
|
|
13
13
|
[](#mcp-сервер)
|
|
14
|
-
[](#установка)
|
|
15
15
|
[](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
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
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
|
-
**Содержание:** [Чем
|
|
49
|
+
**Содержание:** [Чем хорош Better-TG-CLI](#чем-хорош-better-tg-cli) · [Установка](#установка) · [Вход](#вход) · [Использование](#использование) · [MCP-сервер](#mcp-сервер) · [FAQ](#faq) · [Разработка](#разработка) · [Приватность](#приватность) · [Лицензия](#лицензия)
|
|
46
50
|
|
|
47
|
-
## Чем
|
|
51
|
+
## Чем хорош Better-TG-CLI
|
|
48
52
|
|
|
49
|
-
|
|
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
|