npm - better-tg-cli - Versions diffs - 0.27.0 → 0.28.0 - Mend

better-tg-cli 0.27.0 → 0.28.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 (6) hide show

package/README.md +17 -3
package/README.ru.md +17 -3
package/dist/telegram.mjs +1 -1
package/package.json +2 -2
package/skills/better-tg-cli/SKILL.md +1 -1
package/skills/better-tg-cli/reference.md +1 -1

package/README.md CHANGED Viewed

@@ -66,9 +66,18 @@ A fork of [skillhq/telegram](https://github.com/skillhq/telegram), reworked for
 ```bash
 brew install thevilfer/tap/better-tg-cli   # standalone binary, macOS and Linux
-npm install -g better-tg-cli               # Node >= 20
+npm install -g better-tg-cli               # Node >= 20, any OS
 ```
+On Windows (experimental), with [Scoop](https://scoop.sh) or npm:
+```powershell
+scoop bucket add thevilfer https://github.com/TheVilfer/scoop-bucket
+scoop install better-tg-cli
+```
+The Windows `telegram.exe` is not code-signed, so SmartScreen may warn about the release download.
 `telegram update` upgrades an existing install, whichever of these you used. On a terminal the CLI
 checks for new versions once a day. Agents and pipes never see that notice, and
 `TG_NO_UPDATE_CHECK=1` turns it off.
@@ -84,6 +93,7 @@ Every channel ships the same version from one release:
 |---|---|---|
 | [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` |
+| [Scoop](https://github.com/TheVilfer/scoop-bucket) (Windows, experimental) | standalone `telegram.exe` | `scoop bucket add thevilfer https://github.com/TheVilfer/scoop-bucket` then `scoop install 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) |
 | 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 |
@@ -167,7 +177,9 @@ The session is stored in the macOS Keychain (service `tg-cli`), or in 1Password
 Keyring, KWallet, KeePassXC) through `secret-tool`, which needs the `libsecret-tools` package. A
 session already saved in the config file moves there automatically. Without any secret store, the
 session is kept in `~/.config/tg/config.json5` (mode 0600) and write commands stay disabled.
-On Linux, `write-access on` is confirmed at a terminal prompt.
+On Linux, `write-access on` is confirmed at a terminal prompt. On Windows the secrets live in
+`%APPDATA%\tg\secrets.dpapi`, encrypted with DPAPI for your Windows user (only you on this machine
+can decrypt it), and `write-access on` asks in a Yes/No window when there's no terminal.
 ## Usage
@@ -276,7 +288,9 @@ The session is in the macOS Keychain, the Linux Secret Service or 1Password. The
 Yes, with `TG_PROFILE`: each profile has its own login, config and Keychain items, for example `TG_PROFILE=work telegram auth --qr`. Switching accounts properly is tracked in [#5](https://github.com/TheVilfer/better-tg-cli/issues/5).
 **Does it work on Windows?**
-Not yet. It is built and tested on macOS and Linux, and relies on their secret stores.
+Yes, experimentally: `scoop install better-tg-cli` or npm. Secrets are stored with Windows DPAPI
+and CI runs the tests on Windows, but live use there is less tested than on macOS and Linux. Please
+report problems in the issues.
 **Can I use it from Grok Bot, ChatGPT or another cloud agent?**
 Cloud agents can't start a program on your computer, so run the MCP server over HTTP and reach it through a tunnel. See [Grok Bot](#grok-bot-remote-mcp-over-http).

package/README.ru.md CHANGED Viewed

@@ -65,9 +65,18 @@ $ telegram inbox -n 3
 ```bash
 brew install thevilfer/tap/better-tg-cli   # отдельный бинарник, macOS и Linux
-npm install -g better-tg-cli               # Node >= 20
+npm install -g better-tg-cli               # Node >= 20, любая ОС
 ```
+На Windows (экспериментально) через [Scoop](https://scoop.sh) или npm:
+```powershell
+scoop bucket add thevilfer https://github.com/TheVilfer/scoop-bucket
+scoop install better-tg-cli
+```
+`telegram.exe` для Windows не подписан, поэтому SmartScreen может предупредить при скачивании из релиза.
 `telegram update` обновляет CLI тем же способом, каким он был установлен. В терминале CLI раз в
 сутки проверяет, не вышла ли новая версия. Агенты и пайпы этого уведомления не видят, а
 `TG_NO_UPDATE_CHECK=1` отключает его совсем.
@@ -83,6 +92,7 @@ npm install -g better-tg-cli               # Node >= 20
 |---|---|---|
 | [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` |
+| [Scoop](https://github.com/TheVilfer/scoop-bucket) (Windows, экспериментально) | отдельный `telegram.exe` | `scoop bucket add thevilfer https://github.com/TheVilfer/scoop-bucket`, затем `scoop install better-tg-cli` |
 | [GitHub Releases](https://github.com/TheVilfer/better-tg-cli/releases) | бинарники и SHA256SUMS | скачать вручную |
 | Плагин Claude Code | скилл и MCP-сервер | [см. ниже](#плагин-для-claude-code) |
 | Расширение Claude Desktop | MCP-сервер на встроенном Node из Claude | [скачать `.mcpb`](https://github.com/TheVilfer/better-tg-cli/releases/latest/download/better-tg-cli.mcpb) и открыть |
@@ -167,7 +177,9 @@ npx skills add TheVilfer/better-tg-cli -g -a claude-code -a codex -y
 KeePassXC) через `secret-tool`, для этого нужен пакет `libsecret-tools`. Сессия, которая уже лежит
 в конфиге, переедет туда сама. Если хранилища секретов нет, сессия лежит в
 `~/.config/tg/config.json5` (права 0600), а запись остаётся выключенной. На Linux
-`write-access on` подтверждается в терминале.
+`write-access on` подтверждается в терминале. На Windows секреты лежат в
+`%APPDATA%\tg\secrets.dpapi`, зашифрованные DPAPI для вашего пользователя Windows (расшифровать их
+можете только вы на этой машине), а `write-access on` без терминала спрашивает в окне «Да/Нет».
 ## Использование
@@ -277,7 +289,9 @@ tailscale funnel --bg 8787                  # или: cloudflared tunnel --url h
 Да, через `TG_PROFILE`: у каждого профиля свой вход, конфиг и записи в Keychain, например `TG_PROFILE=work telegram auth --qr`. Удобное переключение аккаунтов — в [#5](https://github.com/TheVilfer/better-tg-cli/issues/5).
 **Работает ли на Windows?**
-Пока нет. CLI собирается и проверяется на macOS и Linux и опирается на их хранилища секретов.
+Да, экспериментально: `scoop install better-tg-cli` или npm. Секреты хранятся через Windows DPAPI,
+тесты гоняются на Windows в CI, но вживую там проверено меньше, чем на macOS и Linux. О проблемах
+пишите в issues.
 **Можно ли пользоваться из Grok Bot, ChatGPT или другого облачного агента?**
 Облачный агент не может запустить программу на вашем компьютере, поэтому поднимите MCP-сервер по HTTP и откройте к нему туннель. См. [Grok Bot](#grok-bot-удалённый-mcp-по-http).