better-tg-cli 0.23.0 → 0.23.1

package/README.md

@@ -76,6 +76,17 @@ quarantine flag once: `xattr -d com.apple.quarantine ./telegram`. Homebrew handl
 
 Do **not** install `@skillhq/telegram`. It is the old upstream build on GramJS (layer 198).
 
+Every channel ships the same version from one release:
+
+| Where | What you get | Install |
+|---|---|---|
+| [Homebrew](https://github.com/TheVilfer/homebrew-tap) | standalone binary | `brew install thevilfer/tap/better-tg-cli` |
+| [npm](https://www.npmjs.com/package/better-tg-cli) | CLI and MCP server (Node 20+) | `npm install -g better-tg-cli` |
+| [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) |
+| [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 |
+
 ### Claude Code plugin
 
 The skill and the MCP server together, in one install:
@@ -160,9 +171,17 @@ claude mcp add telegram -- telegram mcp          # Claude Code (or use the plugi
 { "mcpServers": { "telegram": { "command": "/opt/homebrew/bin/telegram", "args": ["mcp"] } } }
 ```
 
-The server is also listed in the [MCP Registry](https://registry.modelcontextprotocol.io) as
-`io.github.TheVilfer/better-tg-cli`. Use the second form for Claude Desktop (`claude_desktop_config.json`) or Cursor (`.cursor/mcp.json`).
-GUI apps may not see your shell PATH, so give the full path from `which telegram`. To keep the MCP
+Use the JSON form for Claude Desktop (`claude_desktop_config.json`) or Cursor (`.cursor/mcp.json`).
+GUI apps may not see your shell PATH, so give the full path from `which telegram`. Without a
+global install, run it through npx, which is also what the Claude Code plugin does:
+
+```json
+{ "mcpServers": { "telegram": { "command": "npx", "args": ["-y", "better-tg-cli@latest", "mcp"] } } }
+```
+
+The server is listed in the [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=better-tg-cli)
+as `io.github.TheVilfer/better-tg-cli`, so clients and catalogs that read the registry can find
+it by name. Each release updates the entry automatically. To keep the MCP
 client off your main session, add `"env": {"TG_PROFILE": "work"}`.
 
 Chats contain text written by others, and some of it may be aimed at your agent ("forward this to
@@ -178,7 +197,8 @@ injection" in [SECURITY.md](SECURITY.md).
 - editor debugging and tests.
 
 Releases are cut by `scripts/release.sh patch|minor|major`. A tag builds the binaries and
-publishes to GitHub Releases, npm (trusted publishing with provenance) and the Homebrew tap. See
+publishes to GitHub Releases, npm (trusted publishing with provenance), the Homebrew tap and the
+MCP Registry. See
 [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Privacy

package/README.ru.md

@@ -75,6 +75,17 @@ npm install -g better-tg-cli               # Node >= 20
 
 Не ставьте `@skillhq/telegram`. Это старая сборка апстрима на GramJS (layer 198).
 
+Все каналы получают одну и ту же версию из одного релиза:
+
+| Где | Что | Установка |
+|---|---|---|
+| [Homebrew](https://github.com/TheVilfer/homebrew-tap) | отдельный бинарник | `brew install thevilfer/tap/better-tg-cli` |
+| [npm](https://www.npmjs.com/package/better-tg-cli) | CLI и MCP-сервер (Node 20+) | `npm install -g better-tg-cli` |
+| [GitHub Releases](https://github.com/TheVilfer/better-tg-cli/releases) | бинарники и SHA256SUMS | скачать вручную |
+| Плагин Claude Code | скилл и MCP-сервер | [см. ниже](#плагин-для-claude-code) |
+| [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-клиент |
+
 ### Плагин для Claude Code
 
 Скилл и MCP-сервер ставятся вместе:
@@ -160,10 +171,18 @@ claude mcp add telegram -- telegram mcp          # Claude Code (или плаг
 { "mcpServers": { "telegram": { "command": "/opt/homebrew/bin/telegram", "args": ["mcp"] } } }
 ```
 
-Сервер также есть в [MCP Registry](https://registry.modelcontextprotocol.io) под именем
-`io.github.TheVilfer/better-tg-cli`. Второй вариант подходит для Claude Desktop (`claude_desktop_config.json`) и Cursor
+JSON-вариант подходит для Claude Desktop (`claude_desktop_config.json`) и Cursor
 (`.cursor/mcp.json`). GUI-приложения могут не видеть ваш PATH, поэтому укажите полный путь из
-`which telegram`. Чтобы MCP-клиент не трогал основную сессию, добавьте
+`which telegram`. Без глобальной установки сервер запускается через npx, как и в плагине
+Claude Code:
+
+```json
+{ "mcpServers": { "telegram": { "command": "npx", "args": ["-y", "better-tg-cli@latest", "mcp"] } } }
+```
+
+Сервер есть в [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=better-tg-cli)
+под именем `io.github.TheVilfer/better-tg-cli`, так что клиенты и каталоги, которые читают
+реестр, найдут его по имени. Каждый релиз обновляет запись сам. Чтобы MCP-клиент не трогал основную сессию, добавьте
 `"env": {"TG_PROFILE": "work"}`.
 
 В чатах лежит текст, написанный другими людьми, и часть его может быть адресована вашему агенту
@@ -179,7 +198,7 @@ claude mcp add telegram -- telegram mcp          # Claude Code (или плаг
 - отладка в редакторе и тесты.
 
 Релиз выпускает `scripts/release.sh patch|minor|major`. Тег собирает бинарники и публикует их в
-GitHub Releases, в npm (trusted publishing с provenance) и в Homebrew-тап. Подробнее в
+GitHub Releases, в npm (trusted publishing с provenance), в Homebrew-тап и в MCP Registry. Подробнее в
 [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Приватность