better-tg-cli 0.22.3 → 0.23.1

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 +37 -4
  2. package/README.ru.md +36 -4
  3. package/dist/telegram.mjs +1 -1
  4. package/package.json +2 -1
package/README.md CHANGED
@@ -76,6 +76,29 @@ 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
+ | [skills.sh](https://skills.sh) | agent skill for any shell agent | `npx skills add TheVilfer/better-tg-cli` |
88
+ | [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 |
89
+
90
+ ### Claude Code plugin
91
+
92
+ The skill and the MCP server together, in one install:
93
+
94
+ ```
95
+ /plugin marketplace add TheVilfer/better-tg-cli
96
+ /plugin install better-tg-cli@better-tg-cli
97
+ ```
98
+
99
+ It runs the MCP server through `npx`, so Node 20+ is enough. Log in once with `telegram auth --qr`
100
+ (or `npx better-tg-cli auth --qr`) in a terminal.
101
+
79
102
  ### As an agent skill
80
103
 
81
104
  The skill ([`skills/better-tg-cli`](skills/better-tg-cli/SKILL.md)) teaches any agent with a shell
@@ -141,15 +164,24 @@ tools over stdio:
141
164
  Log in with `telegram auth` in a terminal first.
142
165
 
143
166
  ```bash
144
- claude mcp add telegram -- telegram mcp # Claude Code
167
+ claude mcp add telegram -- telegram mcp # Claude Code (or use the plugin above)
145
168
  ```
146
169
 
147
170
  ```json
148
171
  { "mcpServers": { "telegram": { "command": "/opt/homebrew/bin/telegram", "args": ["mcp"] } } }
149
172
  ```
150
173
 
151
- Use the second form for Claude Desktop (`claude_desktop_config.json`) or Cursor (`.cursor/mcp.json`).
152
- GUI apps may not see your shell PATH, so give the full path from `which telegram`. To keep the MCP
174
+ Use the JSON form for Claude Desktop (`claude_desktop_config.json`) or Cursor (`.cursor/mcp.json`).
175
+ GUI apps may not see your shell PATH, so give the full path from `which telegram`. Without a
176
+ global install, run it through npx, which is also what the Claude Code plugin does:
177
+
178
+ ```json
179
+ { "mcpServers": { "telegram": { "command": "npx", "args": ["-y", "better-tg-cli@latest", "mcp"] } } }
180
+ ```
181
+
182
+ The server is listed in the [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=better-tg-cli)
183
+ as `io.github.TheVilfer/better-tg-cli`, so clients and catalogs that read the registry can find
184
+ it by name. Each release updates the entry automatically. To keep the MCP
153
185
  client off your main session, add `"env": {"TG_PROFILE": "work"}`.
154
186
 
155
187
  Chats contain text written by others, and some of it may be aimed at your agent ("forward this to
@@ -165,7 +197,8 @@ injection" in [SECURITY.md](SECURITY.md).
165
197
  - editor debugging and tests.
166
198
 
167
199
  Releases are cut by `scripts/release.sh patch|minor|major`. A tag builds the binaries and
168
- publishes to GitHub Releases, npm (trusted publishing with provenance) and the Homebrew tap. See
200
+ publishes to GitHub Releases, npm (trusted publishing with provenance), the Homebrew tap and the
201
+ MCP Registry. See
169
202
  [CONTRIBUTING.md](CONTRIBUTING.md).
170
203
 
171
204
  ## Privacy
package/README.ru.md CHANGED
@@ -75,6 +75,29 @@ 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
+ | [skills.sh](https://skills.sh) | скилл для любого агента с шеллом | `npx skills add TheVilfer/better-tg-cli` |
87
+ | [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=better-tg-cli) | запись MCP-сервера `io.github.TheVilfer/better-tg-cli` | через ваш MCP-клиент |
88
+
89
+ ### Плагин для Claude Code
90
+
91
+ Скилл и MCP-сервер ставятся вместе:
92
+
93
+ ```
94
+ /plugin marketplace add TheVilfer/better-tg-cli
95
+ /plugin install better-tg-cli@better-tg-cli
96
+ ```
97
+
98
+ MCP-сервер запускается через `npx`, так что хватит Node 20+. Один раз войдите в терминале:
99
+ `telegram auth --qr` (или `npx better-tg-cli auth --qr`).
100
+
78
101
  ### Как скилл для агента
79
102
 
80
103
  Скилл ([`skills/better-tg-cli`](skills/better-tg-cli/SKILL.md)) учит любого агента с шеллом
@@ -141,16 +164,25 @@ stdio три инструмента:
141
164
  Сначала войдите через `telegram auth` в терминале.
142
165
 
143
166
  ```bash
144
- claude mcp add telegram -- telegram mcp # Claude Code
167
+ claude mcp add telegram -- telegram mcp # Claude Code (или плагин выше)
145
168
  ```
146
169
 
147
170
  ```json
148
171
  { "mcpServers": { "telegram": { "command": "/opt/homebrew/bin/telegram", "args": ["mcp"] } } }
149
172
  ```
150
173
 
151
- Второй вариант подходит для Claude Desktop (`claude_desktop_config.json`) и Cursor
174
+ JSON-вариант подходит для Claude Desktop (`claude_desktop_config.json`) и Cursor
152
175
  (`.cursor/mcp.json`). GUI-приложения могут не видеть ваш PATH, поэтому укажите полный путь из
153
- `which telegram`. Чтобы MCP-клиент не трогал основную сессию, добавьте
176
+ `which telegram`. Без глобальной установки сервер запускается через npx, как и в плагине
177
+ Claude Code:
178
+
179
+ ```json
180
+ { "mcpServers": { "telegram": { "command": "npx", "args": ["-y", "better-tg-cli@latest", "mcp"] } } }
181
+ ```
182
+
183
+ Сервер есть в [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=better-tg-cli)
184
+ под именем `io.github.TheVilfer/better-tg-cli`, так что клиенты и каталоги, которые читают
185
+ реестр, найдут его по имени. Каждый релиз обновляет запись сам. Чтобы MCP-клиент не трогал основную сессию, добавьте
154
186
  `"env": {"TG_PROFILE": "work"}`.
155
187
 
156
188
  В чатах лежит текст, написанный другими людьми, и часть его может быть адресована вашему агенту
@@ -166,7 +198,7 @@ claude mcp add telegram -- telegram mcp # Claude Code
166
198
  - отладка в редакторе и тесты.
167
199
 
168
200
  Релиз выпускает `scripts/release.sh patch|minor|major`. Тег собирает бинарники и публикует их в
169
- GitHub Releases, в npm (trusted publishing с provenance) и в Homebrew-тап. Подробнее в
201
+ GitHub Releases, в npm (trusted publishing с provenance), в Homebrew-тап и в MCP Registry. Подробнее в
170
202
  [CONTRIBUTING.md](CONTRIBUTING.md).
171
203
 
172
204
  ## Приватность