better-tg-cli 0.22.3 → 0.23.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.
- package/README.md +15 -2
- package/README.ru.md +15 -2
- package/dist/telegram.mjs +1 -1
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -76,6 +76,18 @@ 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
|
+
### Claude Code plugin
|
|
80
|
+
|
|
81
|
+
The skill and the MCP server together, in one install:
|
|
82
|
+
|
|
83
|
+
```
|
|
84
|
+
/plugin marketplace add TheVilfer/better-tg-cli
|
|
85
|
+
/plugin install better-tg-cli@better-tg-cli
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
It runs the MCP server through `npx`, so Node 20+ is enough. Log in once with `telegram auth --qr`
|
|
89
|
+
(or `npx better-tg-cli auth --qr`) in a terminal.
|
|
90
|
+
|
|
79
91
|
### As an agent skill
|
|
80
92
|
|
|
81
93
|
The skill ([`skills/better-tg-cli`](skills/better-tg-cli/SKILL.md)) teaches any agent with a shell
|
|
@@ -141,14 +153,15 @@ tools over stdio:
|
|
|
141
153
|
Log in with `telegram auth` in a terminal first.
|
|
142
154
|
|
|
143
155
|
```bash
|
|
144
|
-
claude mcp add telegram -- telegram mcp # Claude Code
|
|
156
|
+
claude mcp add telegram -- telegram mcp # Claude Code (or use the plugin above)
|
|
145
157
|
```
|
|
146
158
|
|
|
147
159
|
```json
|
|
148
160
|
{ "mcpServers": { "telegram": { "command": "/opt/homebrew/bin/telegram", "args": ["mcp"] } } }
|
|
149
161
|
```
|
|
150
162
|
|
|
151
|
-
|
|
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`).
|
|
152
165
|
GUI apps may not see your shell PATH, so give the full path from `which telegram`. To keep the MCP
|
|
153
166
|
client off your main session, add `"env": {"TG_PROFILE": "work"}`.
|
|
154
167
|
|
package/README.ru.md
CHANGED
|
@@ -75,6 +75,18 @@ npm install -g better-tg-cli # Node >= 20
|
|
|
75
75
|
|
|
76
76
|
Не ставьте `@skillhq/telegram`. Это старая сборка апстрима на GramJS (layer 198).
|
|
77
77
|
|
|
78
|
+
### Плагин для Claude Code
|
|
79
|
+
|
|
80
|
+
Скилл и MCP-сервер ставятся вместе:
|
|
81
|
+
|
|
82
|
+
```
|
|
83
|
+
/plugin marketplace add TheVilfer/better-tg-cli
|
|
84
|
+
/plugin install better-tg-cli@better-tg-cli
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
MCP-сервер запускается через `npx`, так что хватит Node 20+. Один раз войдите в терминале:
|
|
88
|
+
`telegram auth --qr` (или `npx better-tg-cli auth --qr`).
|
|
89
|
+
|
|
78
90
|
### Как скилл для агента
|
|
79
91
|
|
|
80
92
|
Скилл ([`skills/better-tg-cli`](skills/better-tg-cli/SKILL.md)) учит любого агента с шеллом
|
|
@@ -141,14 +153,15 @@ stdio три инструмента:
|
|
|
141
153
|
Сначала войдите через `telegram auth` в терминале.
|
|
142
154
|
|
|
143
155
|
```bash
|
|
144
|
-
claude mcp add telegram -- telegram mcp # Claude Code
|
|
156
|
+
claude mcp add telegram -- telegram mcp # Claude Code (или плагин выше)
|
|
145
157
|
```
|
|
146
158
|
|
|
147
159
|
```json
|
|
148
160
|
{ "mcpServers": { "telegram": { "command": "/opt/homebrew/bin/telegram", "args": ["mcp"] } } }
|
|
149
161
|
```
|
|
150
162
|
|
|
151
|
-
|
|
163
|
+
Сервер также есть в [MCP Registry](https://registry.modelcontextprotocol.io) под именем
|
|
164
|
+
`io.github.TheVilfer/better-tg-cli`. Второй вариант подходит для Claude Desktop (`claude_desktop_config.json`) и Cursor
|
|
152
165
|
(`.cursor/mcp.json`). GUI-приложения могут не видеть ваш PATH, поэтому укажите полный путь из
|
|
153
166
|
`which telegram`. Чтобы MCP-клиент не трогал основную сессию, добавьте
|
|
154
167
|
`"env": {"TG_PROFILE": "work"}`.
|