better-tg-cli 0.28.0 → 0.29.0

package/README.md

@@ -117,6 +117,15 @@ The skill and the MCP server together, in one install:
 It runs the MCP server through `npx`, so Node 20+ is enough. Log in once with `telegram auth --qr`
 (or `npx better-tg-cli auth --qr`) in a terminal.
 
+### Codex plugin
+
+The same skill and MCP server as a Codex plugin (also shows up in the ChatGPT desktop app):
+
+```bash
+codex plugin marketplace add TheVilfer/better-tg-cli
+codex plugin add better-tg-cli@better-tg-cli
+```
+
 ### Grok Build plugin
 
 [Grok Build](https://x.ai/cli) installs the same plugin, skill and MCP server together:
@@ -307,17 +316,43 @@ If you installed the agent skill with `telegram skill install`, run that again t
 - Telegram test servers;
 - editor debugging and tests.
 
-Releases are cut by `scripts/release.sh patch|minor|major`. A tag builds the binaries and
+Releases are cut by `scripts/release.sh patch|minor|major` (a release PR), then `scripts/release.sh tag` after the merge. A tag builds the binaries and
 publishes to GitHub Releases, npm (trusted publishing with provenance), the Homebrew tap and the
 MCP Registry. See
 [CONTRIBUTING.md](CONTRIBUTING.md).
 
+## Uninstall
+
+1. `telegram logout` deletes the saved session. To end it on Telegram's side too, terminate it in
+   Telegram → Settings → Devices.
+2. `telegram skill uninstall` removes the skill from the agents it was installed into.
+3. Remove the program: `brew uninstall better-tg-cli`, `npm uninstall -g better-tg-cli` or
+   `scoop uninstall better-tg-cli`. For a binary from Releases, delete `telegram` / `telegram.exe`.
+4. Delete the config folder: `~/.config/tg` (`%APPDATA%\tg` on Windows), plus `~/.config/tg-<profile>`
+   for any `TG_PROFILE` you used. On Windows this also removes the DPAPI secrets file. Elsewhere the
+   api_hash and write-access flag stay in the secret store: delete the `tg-cli` items in Keychain
+   Access (or `secret-tool clear service tg-cli`), or the item in your 1Password vault.
+
 ## Privacy
 
 No analytics. The only service we run is the optional invite broker, which never sees your
 messages or session. See [PRIVACY.md](PRIVACY.md) for the three hosts the CLI talks to and what it
 stores locally.
 
+## Code signing policy
+
+Windows binaries are built from this repository by GitHub Actions only (`.github/workflows/release.yml`),
+never on a personal machine. We have applied for free code signing from SignPath Foundation; once it
+is in place, release binaries will carry: *Free code signing provided by
+[SignPath.io](https://about.signpath.io), certificate by [SignPath Foundation](https://signpath.org).*
+Until then the Windows `telegram.exe` is unsigned; macOS binaries are ad-hoc signed.
+
+- Committers and reviewers: [@TheVilfer](https://github.com/TheVilfer)
+- Approvers (each signed release): [@TheVilfer](https://github.com/TheVilfer)
+- Privacy policy: [PRIVACY.md](PRIVACY.md). The CLI talks only to Telegram, to the invite broker
+  when you log in with an invite, and to the npm registry for a daily update check in a terminal
+  (off with `TG_NO_UPDATE_CHECK=1`).
+
 ## License
 
 MIT, see [LICENSE](LICENSE). Based on [skillhq/telegram](https://github.com/skillhq/telegram) by

package/README.ru.md

@@ -116,6 +116,15 @@ scoop install better-tg-cli
 MCP-сервер запускается через `npx`, так что хватит Node 20+. Один раз войдите в терминале:
 `telegram auth --qr` (или `npx better-tg-cli auth --qr`).
 
+### Плагин для Codex
+
+Тот же скилл и MCP-сервер в виде плагина Codex (он появится и в десктопном приложении ChatGPT):
+
+```bash
+codex plugin marketplace add TheVilfer/better-tg-cli
+codex plugin add better-tg-cli@better-tg-cli
+```
+
 ### Плагин для Grok Build
 
 [Grok Build](https://x.ai/cli) ставит тот же плагин, скилл и MCP-сервер вместе:
@@ -308,16 +317,42 @@ tailscale funnel --bg 8787                  # или: cloudflared tunnel --url h
 - тестовые серверы Telegram;
 - отладка в редакторе и тесты.
 
-Релиз выпускает `scripts/release.sh patch|minor|major`. Тег собирает бинарники и публикует их в
+Релиз готовит `scripts/release.sh patch|minor|major` (PR с новой версией), после мержа `scripts/release.sh tag` ставит тег. Тег собирает бинарники и публикует их в
 GitHub Releases, в npm (trusted publishing с provenance), в Homebrew-тап и в MCP Registry. Подробнее в
 [CONTRIBUTING.md](CONTRIBUTING.md).
 
+## Удаление
+
+1. `telegram logout` удаляет сохранённую сессию. Чтобы завершить её и на стороне Telegram,
+   закройте её в Telegram → Настройки → Устройства.
+2. `telegram skill uninstall` убирает скилл из агентов, куда он был установлен.
+3. Удалите саму программу: `brew uninstall better-tg-cli`, `npm uninstall -g better-tg-cli` или
+   `scoop uninstall better-tg-cli`. Бинарник из Releases удаляется как обычный файл.
+4. Удалите папку настроек: `~/.config/tg` (`%APPDATA%\tg` на Windows) и `~/.config/tg-<профиль>`
+   для каждого `TG_PROFILE`, который вы использовали. На Windows вместе с ней удалится и файл секретов
+   DPAPI. На других системах api_hash и флаг write-access остаются в хранилище секретов: удалите
+   записи `tg-cli` в «Связке ключей» (или `secret-tool clear service tg-cli`) либо запись в 1Password.
+
 ## Приватность
 
 Аналитики нет. Единственный наш сервис — необязательный брокер инвайтов, и он не видит ни ваших
 сообщений, ни сессии. В [PRIVACY.md](PRIVACY.md) перечислены три хоста, с которыми общается CLI,
 и то, что он хранит локально.
 
+## Code signing policy
+
+Бинарники для Windows собираются из этого репозитория только в GitHub Actions
+(`.github/workflows/release.yml`), никогда не на личной машине. Мы подали заявку на бесплатную
+подпись кода от SignPath Foundation; когда её одобрят, в релизах будет: *Free code signing provided
+by [SignPath.io](https://about.signpath.io), certificate by [SignPath Foundation](https://signpath.org).*
+Пока `telegram.exe` для Windows не подписан; бинарники для macOS подписаны ad-hoc.
+
+- Коммиттеры и ревьюеры: [@TheVilfer](https://github.com/TheVilfer)
+- Утверждают каждый подписанный релиз: [@TheVilfer](https://github.com/TheVilfer)
+- Политика приватности: [PRIVACY.md](PRIVACY.md). CLI обращается только к Telegram, к брокеру
+  инвайтов при входе по инвайту и раз в день к npm-реестру за номером версии, если запущен в
+  терминале (отключается `TG_NO_UPDATE_CHECK=1`).
+
 ## Лицензия
 
 MIT, см. [LICENSE](LICENSE). Основано на [skillhq/telegram](https://github.com/skillhq/telegram)