better-tg-cli 0.23.0 → 0.24.0

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.
Files changed (4) hide show
  1. package/README.md +36 -5
  2. package/README.ru.md +35 -5
  3. package/dist/telegram.mjs +1 -1
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -76,6 +76,20 @@ quarantine flag once: `xattr -d com.apple.quarantine ./telegram`. Homebrew handl
76
76
 
77
77
  Do **not** install `@skillhq/telegram`. It is the old upstream build on GramJS (layer 198).
78
78
 
79
+ Every channel ships the same version from one release:
80
+
81
+ | Where | What you get | Install |
82
+ |---|---|---|
83
+ | [Homebrew](https://github.com/TheVilfer/homebrew-tap) | standalone binary | `brew install thevilfer/tap/better-tg-cli` |
84
+ | [npm](https://www.npmjs.com/package/better-tg-cli) | CLI and MCP server (Node 20+) | `npm install -g better-tg-cli` |
85
+ | [GitHub Releases](https://github.com/TheVilfer/better-tg-cli/releases) | binaries and SHA256SUMS | download by hand |
86
+ | Claude Code plugin | skill and MCP server | [see below](#claude-code-plugin) |
87
+ | 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 |
88
+ | Gemini CLI extension | skill and MCP server | `gemini extensions install https://github.com/TheVilfer/better-tg-cli` |
89
+ | Cursor, VS Code | MCP server | [one-click buttons](#mcp-server) |
90
+ | [skills.sh](https://skills.sh) | agent skill for any shell agent | `npx skills add TheVilfer/better-tg-cli` |
91
+ | [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 |
92
+
79
93
  ### Claude Code plugin
80
94
 
81
95
  The skill and the MCP server together, in one install:
@@ -150,7 +164,15 @@ tools over stdio:
150
164
  - `telegram_read`: read-only, so clients may auto-approve it;
151
165
  - `telegram_write`: marked destructive, and still needs `write-access on` from you.
152
166
 
153
- Log in with `telegram auth` in a terminal first.
167
+ Log in with `telegram auth` in a terminal first. Then install it in one click:
168
+
169
+ [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=telegram&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImJldHRlci10Zy1jbGlAbGF0ZXN0IiwibWNwIl19)
170
+ [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP-000000?style=flat&colorA=000000&colorB=000000)](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522telegram%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522better-tg-cli%2540latest%2522%252C%2522mcp%2522%255D%257D)
171
+ [![Claude Desktop extension](https://img.shields.io/badge/Claude_Desktop-.mcpb-000000?style=flat&colorA=000000&colorB=000000&logo=claude)](https://github.com/TheVilfer/better-tg-cli/releases/latest/download/better-tg-cli.mcpb)
172
+
173
+ The Claude Desktop extension needs no Node, npm or brew: download the `.mcpb` from the latest
174
+ release and open it. Gemini CLI takes the skill and the server together:
175
+ `gemini extensions install https://github.com/TheVilfer/better-tg-cli`. Or add it by hand:
154
176
 
155
177
  ```bash
156
178
  claude mcp add telegram -- telegram mcp # Claude Code (or use the plugin above)
@@ -160,9 +182,17 @@ claude mcp add telegram -- telegram mcp # Claude Code (or use the plugi
160
182
  { "mcpServers": { "telegram": { "command": "/opt/homebrew/bin/telegram", "args": ["mcp"] } } }
161
183
  ```
162
184
 
163
- The server is also listed in the [MCP Registry](https://registry.modelcontextprotocol.io) as
164
- `io.github.TheVilfer/better-tg-cli`. Use the second form for Claude Desktop (`claude_desktop_config.json`) or Cursor (`.cursor/mcp.json`).
165
- GUI apps may not see your shell PATH, so give the full path from `which telegram`. To keep the MCP
185
+ Use the JSON form for Claude Desktop (`claude_desktop_config.json`) or Cursor (`.cursor/mcp.json`).
186
+ GUI apps may not see your shell PATH, so give the full path from `which telegram`. Without a
187
+ global install, run it through npx, which is also what the Claude Code plugin does:
188
+
189
+ ```json
190
+ { "mcpServers": { "telegram": { "command": "npx", "args": ["-y", "better-tg-cli@latest", "mcp"] } } }
191
+ ```
192
+
193
+ The server is listed in the [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=better-tg-cli)
194
+ as `io.github.TheVilfer/better-tg-cli`, so clients and catalogs that read the registry can find
195
+ it by name. Each release updates the entry automatically. To keep the MCP
166
196
  client off your main session, add `"env": {"TG_PROFILE": "work"}`.
167
197
 
168
198
  Chats contain text written by others, and some of it may be aimed at your agent ("forward this to
@@ -178,7 +208,8 @@ injection" in [SECURITY.md](SECURITY.md).
178
208
  - editor debugging and tests.
179
209
 
180
210
  Releases are cut by `scripts/release.sh patch|minor|major`. A tag builds the binaries and
181
- publishes to GitHub Releases, npm (trusted publishing with provenance) and the Homebrew tap. See
211
+ publishes to GitHub Releases, npm (trusted publishing with provenance), the Homebrew tap and the
212
+ MCP Registry. See
182
213
  [CONTRIBUTING.md](CONTRIBUTING.md).
183
214
 
184
215
  ## Privacy
package/README.ru.md CHANGED
@@ -75,6 +75,20 @@ npm install -g better-tg-cli # Node >= 20
75
75
 
76
76
  Не ставьте `@skillhq/telegram`. Это старая сборка апстрима на GramJS (layer 198).
77
77
 
78
+ Все каналы получают одну и ту же версию из одного релиза:
79
+
80
+ | Где | Что | Установка |
81
+ |---|---|---|
82
+ | [Homebrew](https://github.com/TheVilfer/homebrew-tap) | отдельный бинарник | `brew install thevilfer/tap/better-tg-cli` |
83
+ | [npm](https://www.npmjs.com/package/better-tg-cli) | CLI и MCP-сервер (Node 20+) | `npm install -g better-tg-cli` |
84
+ | [GitHub Releases](https://github.com/TheVilfer/better-tg-cli/releases) | бинарники и SHA256SUMS | скачать вручную |
85
+ | Плагин Claude Code | скилл и MCP-сервер | [см. ниже](#плагин-для-claude-code) |
86
+ | Расширение Claude Desktop | MCP-сервер на встроенном Node из Claude | [скачать `.mcpb`](https://github.com/TheVilfer/better-tg-cli/releases/latest/download/better-tg-cli.mcpb) и открыть |
87
+ | Расширение Gemini CLI | скилл и MCP-сервер | `gemini extensions install https://github.com/TheVilfer/better-tg-cli` |
88
+ | Cursor, VS Code | MCP-сервер | [кнопки в один клик](#mcp-сервер) |
89
+ | [skills.sh](https://skills.sh) | скилл для любого агента с шеллом | `npx skills add TheVilfer/better-tg-cli` |
90
+ | [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=better-tg-cli) | запись MCP-сервера `io.github.TheVilfer/better-tg-cli` | через ваш MCP-клиент |
91
+
78
92
  ### Плагин для Claude Code
79
93
 
80
94
  Скилл и MCP-сервер ставятся вместе:
@@ -150,7 +164,15 @@ stdio три инструмента:
150
164
  - `telegram_read` — только чтение, клиенты могут разрешать его без вопросов;
151
165
  - `telegram_write` — помечен как опасный и по-прежнему требует от вас `write-access on`.
152
166
 
153
- Сначала войдите через `telegram auth` в терминале.
167
+ Сначала войдите через `telegram auth` в терминале. Затем установите сервер в один клик:
168
+
169
+ [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=telegram&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImJldHRlci10Zy1jbGlAbGF0ZXN0IiwibWNwIl19)
170
+ [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP-000000?style=flat&colorA=000000&colorB=000000)](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522telegram%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522better-tg-cli%2540latest%2522%252C%2522mcp%2522%255D%257D)
171
+ [![Claude Desktop extension](https://img.shields.io/badge/Claude_Desktop-.mcpb-000000?style=flat&colorA=000000&colorB=000000&logo=claude)](https://github.com/TheVilfer/better-tg-cli/releases/latest/download/better-tg-cli.mcpb)
172
+
173
+ Расширению для Claude Desktop не нужны ни Node, ни npm, ни brew: скачайте `.mcpb` из последнего
174
+ релиза и откройте его. Gemini CLI ставит скилл и сервер вместе:
175
+ `gemini extensions install https://github.com/TheVilfer/better-tg-cli`. Или добавьте вручную:
154
176
 
155
177
  ```bash
156
178
  claude mcp add telegram -- telegram mcp # Claude Code (или плагин выше)
@@ -160,10 +182,18 @@ claude mcp add telegram -- telegram mcp # Claude Code (или плаг
160
182
  { "mcpServers": { "telegram": { "command": "/opt/homebrew/bin/telegram", "args": ["mcp"] } } }
161
183
  ```
162
184
 
163
- Сервер также есть в [MCP Registry](https://registry.modelcontextprotocol.io) под именем
164
- `io.github.TheVilfer/better-tg-cli`. Второй вариант подходит для Claude Desktop (`claude_desktop_config.json`) и Cursor
185
+ JSON-вариант подходит для Claude Desktop (`claude_desktop_config.json`) и Cursor
165
186
  (`.cursor/mcp.json`). GUI-приложения могут не видеть ваш PATH, поэтому укажите полный путь из
166
- `which telegram`. Чтобы MCP-клиент не трогал основную сессию, добавьте
187
+ `which telegram`. Без глобальной установки сервер запускается через npx, как и в плагине
188
+ Claude Code:
189
+
190
+ ```json
191
+ { "mcpServers": { "telegram": { "command": "npx", "args": ["-y", "better-tg-cli@latest", "mcp"] } } }
192
+ ```
193
+
194
+ Сервер есть в [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=better-tg-cli)
195
+ под именем `io.github.TheVilfer/better-tg-cli`, так что клиенты и каталоги, которые читают
196
+ реестр, найдут его по имени. Каждый релиз обновляет запись сам. Чтобы MCP-клиент не трогал основную сессию, добавьте
167
197
  `"env": {"TG_PROFILE": "work"}`.
168
198
 
169
199
  В чатах лежит текст, написанный другими людьми, и часть его может быть адресована вашему агенту
@@ -179,7 +209,7 @@ claude mcp add telegram -- telegram mcp # Claude Code (или плаг
179
209
  - отладка в редакторе и тесты.
180
210
 
181
211
  Релиз выпускает `scripts/release.sh patch|minor|major`. Тег собирает бинарники и публикует их в
182
- GitHub Releases, в npm (trusted publishing с provenance) и в Homebrew-тап. Подробнее в
212
+ GitHub Releases, в npm (trusted publishing с provenance), в Homebrew-тап и в MCP Registry. Подробнее в
183
213
  [CONTRIBUTING.md](CONTRIBUTING.md).
184
214
 
185
215
  ## Приватность