better-tg-cli 0.26.0 → 0.28.0

package/README.md

@@ -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 |
@@ -142,6 +152,12 @@ npx skills add TheVilfer/better-tg-cli -g -a claude-code -a codex -y
 
 ## Log in
 
+**Through your agent** (easiest): ask it to set up Telegram, or run `telegram onboard` yourself. It
+opens a page on 127.0.0.1 where you get an invite from [better-tg-cli.com](https://better-tg-cli.com)
+(it comes back to the page by itself) or enter your own keys, scan a QR code and type your 2FA
+password. The agent only starts the command and waits: it never sees the invite, the QR code or the
+password. The page answers only on a random secret path and closes when you're done.
+
 **With your own API keys** (the default):
 1. Open https://my.telegram.org/apps, create an application, and copy its `api_id` and `api_hash`.
 2. Run `telegram auth --qr` and enter them. Then, on your phone, go to Settings → Devices → Link
@@ -161,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
 
@@ -270,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

@@ -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) и открыть |
@@ -141,6 +151,12 @@ npx skills add TheVilfer/better-tg-cli -g -a claude-code -a codex -y
 
 ## Вход
 
+**Через агента** (проще всего): попросите его подключить Telegram или запустите `telegram onboard`
+сами. Откроется страница на 127.0.0.1: там вы получаете инвайт на [better-tg-cli.com](https://better-tg-cli.com)
+(он сам возвращается на страницу) или вводите свои ключи, сканируете QR и вводите пароль 2FA. Агент
+только запускает команду и ждёт: ни инвайт, ни QR, ни пароль он не видит. Страница отвечает только
+по случайному секретному адресу и закрывается после входа.
+
 **Со своими API-ключами** (основной способ):
 1. Откройте https://my.telegram.org/apps, создайте приложение и скопируйте `api_id` и `api_hash`.
 2. Запустите `telegram auth --qr` и введите их. Затем на телефоне откройте Настройки → Устройства →
@@ -161,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` без терминала спрашивает в окне «Да/Нет».
 
 ## Использование
 
@@ -271,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).