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 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
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
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