better-tg-cli 0.36.0 → 0.37.0-rc.1

package/README.es.md

@@ -169,10 +169,10 @@ npx skills add TheVilfer/better-tg-cli -g -a claude-code -a codex -y
 ## Inicio de sesión
 
 **A través de tu agente** (lo más fácil): pídele que configure Telegram o ejecuta tú mismo
-`telegram onboard`. Abre una página en 127.0.0.1 donde obtienes una invitación de
+`telegram onboard`. Abre una página en 127.0.0.1 donde obtienes una clave de acceso de
 [better-tg-cli.com](https://better-tg-cli.com) (vuelve sola a la página) o introduces tus propias
 claves, escaneas un código QR y escribes tu contraseña de 2FA. El agente solo lanza el comando y
-espera: nunca ve la invitación, el código QR ni la contraseña. La página solo responde en una ruta
+espera: nunca ve la clave de acceso, el código QR ni la contraseña. La página solo responde en una ruta
 secreta aleatoria y se cierra cuando terminas.
 
 **Con tus propias claves de API** (la opción por defecto):
@@ -183,13 +183,14 @@ secreta aleatoria y se cierra cuando terminas.
    inicio de sesión. Si el QR no se escanea con un tema claro del terminal, ejecútalo con
    `TG_QR_INVERT=1`.
 
-**Con una invitación.** Con un token de invitación no necesitas tus propias claves. Consigue uno en
-[better-tg-cli.com](https://better-tg-cli.com) (confirma tu correo con un código; la página está en
-ruso y también tiene una guía de instalación) o pídeselo al mantenedor.
-Ejecuta `telegram auth --invite --qr` y pega el token, o pásalo como `TG_INVITE=…` o `--invite -`. El
-servicio de invitaciones (`broker/`) entrega las claves de la aplicación una sola vez, solo para este
-inicio de sesión. El `api_hash` no se guarda en tu máquina. Las invitaciones son personales, permiten
-un número limitado de inicios de sesión y pueden revocarse.
+**Con una clave de acceso.** Con una clave de acceso no necesitas tus propias claves de API. Consigue
+una en [better-tg-cli.com](https://better-tg-cli.com/login) (confirma tu correo con un código; la
+página también tiene una guía de instalación) o pídesela al mantenedor.
+Ejecuta `telegram auth --login-key --qr` y pega la clave, o pásala como `TG_LOGIN_KEY=…` o
+`--login-key -`. El servicio de acceso (`broker/`) entrega las claves de la aplicación una sola vez,
+solo para este inicio de sesión. El `api_hash` no se guarda en tu máquina. Las claves de acceso son
+personales, sirven en hasta 3 equipos y pueden revocarse. Antes de la 0.37 la clave se llamaba
+invitación: `--invite` y `TG_INVITE` siguen funcionando.
 
 La sesión se guarda en el Keychain de macOS (servicio `tg-cli`) o en 1Password con
 `--op-vault <vault>`. `telegram logout` la elimina. En Linux va al Secret Service (GNOME Keyring,
@@ -301,10 +302,10 @@ Solo después de que actives la escritura. `telegram write-access on` te pide qu
 No. `read`, `inbox` y `search` dejan los chats sin leer. Solo `telegram mark-read` los marca.
 
 **¿Necesito mis propias claves de API?**
-Sí, de [my.telegram.org/apps](https://my.telegram.org/apps). Son gratuitas y se crean en un minuto. Con una invitación de [better-tg-cli.com](https://better-tg-cli.com), `telegram auth --invite --qr` te permite iniciar sesión sin ellas.
+Sí, de [my.telegram.org/apps](https://my.telegram.org/apps). Son gratuitas y se crean en un minuto. Con una clave de acceso de [better-tg-cli.com](https://better-tg-cli.com/login), `telegram auth --login-key --qr` te permite iniciar sesión sin ellas.
 
 **¿Dónde se guarda mi sesión y quién puede ver mis mensajes?**
-La sesión está en el Keychain de macOS, en el Secret Service de Linux o en 1Password. El CLI habla directamente con Telegram y no tiene analíticas. Los únicos otros hosts son npm, para una comprobación diaria de versión, y el servicio de invitaciones al iniciar sesión. Consulta [PRIVACY.md](PRIVACY.md).
+La sesión está en el Keychain de macOS, en el Secret Service de Linux o en 1Password. El CLI habla directamente con Telegram y no tiene analíticas. Los únicos otros hosts son npm, para una comprobación diaria de versión, y el servicio de acceso cuando inicias sesión con una clave de acceso. Consulta [PRIVACY.md](PRIVACY.md).
 
 **¿Puedo usar varias cuentas?**
 Sí, con `TG_PROFILE`: cada perfil tiene su propio inicio de sesión, configuración y elementos del Keychain, por ejemplo `TG_PROFILE=work telegram auth --qr`. El cambio de cuenta propiamente dicho se sigue en [#5](https://github.com/TheVilfer/better-tg-cli/issues/5).
@@ -349,7 +350,7 @@ MCP Registry. Consulta
 
 ## Privacidad
 
-Sin analíticas. El único servicio que operamos es el broker de invitaciones opcional, que nunca ve
+Sin analíticas. El único servicio que operamos es el servicio de acceso opcional, que nunca ve
 tus mensajes ni tu sesión. Consulta [PRIVACY.md](PRIVACY.md) para conocer los tres hosts con los que
 habla el CLI y lo que guarda localmente.
 
@@ -363,8 +364,8 @@ Hasta entonces, el `telegram.exe` de Windows no está firmado; los binarios de m
 
 - Committers y revisores: [@TheVilfer](https://github.com/TheVilfer)
 - Aprobadores (cada release firmada): [@TheVilfer](https://github.com/TheVilfer)
-- Política de privacidad: [PRIVACY.md](PRIVACY.md). El CLI solo habla con Telegram, con el broker de
-  invitaciones cuando inicias sesión con una invitación y con el registro de npm para una
+- Política de privacidad: [PRIVACY.md](PRIVACY.md). El CLI solo habla con Telegram, con el servicio de
+  acceso cuando inicias sesión con una clave de acceso y con el registro de npm para una
   comprobación diaria de actualizaciones en un terminal (se desactiva con `TG_NO_UPDATE_CHECK=1`).
 
 ## Licencia

package/README.md

@@ -164,9 +164,9 @@ 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)
+opens a page on 127.0.0.1 where you get a login key 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 agent only starts the command and waits: it never sees the login key, 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):
@@ -176,12 +176,13 @@ password. The page answers only on a random secret path and closes when you're d
    `telegram auth` asks for your phone number and a login code instead. If the QR won't scan on a
    light terminal theme, run with `TG_QR_INVERT=1`.
 
-**With an invite.** You don't need your own keys with an invite token. Get one at
-[better-tg-cli.com](https://better-tg-cli.com) (confirm your email with a code; the page is in Russian
-and also has an install guide), or from the maintainer.
-Run `telegram auth --invite --qr` and paste the token, or pass it as `TG_INVITE=…` or `--invite -`. The
-invite service (`broker/`) hands out the app's keys once, for this login only. The `api_hash` is not
-kept on your machine. Invites are personal, allow a limited number of logins, and can be revoked.
+**With a login key.** You don't need your own keys with a login key. Get one at
+[better-tg-cli.com](https://better-tg-cli.com/login) (confirm your email with a code; the page also
+has an install guide), or from the maintainer.
+Run `telegram auth --login-key --qr` and paste the key, or pass it as `TG_LOGIN_KEY=…` or
+`--login-key -`. The login service (`broker/`) hands out the app's keys once, for this login only.
+The `api_hash` is not kept on your machine. Login keys are personal, work on up to 3 computers, and
+can be revoked. Before 0.37 the key was called an invite: `--invite` and `TG_INVITE` still work.
 
 The session is stored in the macOS Keychain (service `tg-cli`), or in 1Password with
 `--op-vault <vault>`. `telegram logout` removes it. On Linux it goes to the Secret Service (GNOME
@@ -290,10 +291,10 @@ Only after you turn writes on. `telegram write-access on` asks you to confirm in
 No. `read`, `inbox` and `search` leave chats unread. Only `telegram mark-read` marks them.
 
 **Do I need my own API keys?**
-Yes, from [my.telegram.org/apps](https://my.telegram.org/apps). They are free and take a minute to create. With an invite from [better-tg-cli.com](https://better-tg-cli.com), `telegram auth --invite --qr` logs you in without them.
+Yes, from [my.telegram.org/apps](https://my.telegram.org/apps). They are free and take a minute to create. With a login key from [better-tg-cli.com](https://better-tg-cli.com/login), `telegram auth --login-key --qr` logs you in without them.
 
 **Where is my session stored, and who can see my messages?**
-The session is in the macOS Keychain, the Linux Secret Service or 1Password. The CLI talks to Telegram directly and has no analytics. The only other hosts are npm for a daily version check and the invite service at login. See [PRIVACY.md](PRIVACY.md).
+The session is in the macOS Keychain, the Linux Secret Service or 1Password. The CLI talks to Telegram directly and has no analytics. The only other hosts are npm for a daily version check and the login service when you log in with a login key. See [PRIVACY.md](PRIVACY.md).
 
 **Can I use several accounts?**
 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).
@@ -337,7 +338,7 @@ MCP Registry. See
 
 ## Privacy
 
-No analytics. The only service we run is the optional invite broker, which never sees your
+No analytics. The only service we run is the optional login service, 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.
 
@@ -351,8 +352,8 @@ Until then the Windows `telegram.exe` is unsigned; macOS binaries are ad-hoc sig
 
 - 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
+- Privacy policy: [PRIVACY.md](PRIVACY.md). The CLI talks only to Telegram, to the login service
+  when you log in with a login key, and to the npm registry for a daily update check in a terminal
   (off with `TG_NO_UPDATE_CHECK=1`).
 
 ## License

package/README.ru.md

@@ -163,9 +163,9 @@ 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)
+сами. Откроется страница на 127.0.0.1: там вы получаете ключ входа на [better-tg-cli.com](https://better-tg-cli.com)
 (он сам возвращается на страницу) или вводите свои ключи, сканируете QR и вводите пароль 2FA. Агент
-только запускает команду и ждёт: ни инвайт, ни QR, ни пароль он не видит. Страница отвечает только
+только запускает команду и ждёт: ни ключ входа, ни QR, ни пароль он не видит. Страница отвечает только
 по случайному секретному адресу и закрывается после входа.
 
 **Со своими API-ключами** (основной способ):
@@ -175,13 +175,13 @@ npx skills add TheVilfer/better-tg-cli -g -a claude-code -a codex -y
    Обычный `telegram auth` вместо QR спрашивает номер телефона и код. Если в светлой теме
    терминала QR не сканируется, запустите с `TG_QR_INVERT=1`.
 
-**По инвайту.** С инвайт-токеном свои ключи не нужны. Получите его на
-[better-tg-cli.com](https://better-tg-cli.com) (почта подтверждается кодом, там же гайд по установке)
-или у мейнтейнера. Запустите
-`telegram auth --invite --qr` и вставьте токен. Его также можно передать через `TG_INVITE=…` или
-`--invite -`. Сервис инвайтов (`broker/`) выдаёт ключи приложения один раз, только для этого входа.
-`api_hash` на вашей машине не сохраняется. Инвайты персональные, число входов по ним ограничено, и
-их можно отозвать.
+**По ключу входа.** С ключом входа свои API-ключи не нужны. Получите его на
+[better-tg-cli.com](https://better-tg-cli.com/login) (почта подтверждается кодом, там же гайд по
+установке) или у мейнтейнера. Запустите `telegram auth --login-key --qr` и вставьте ключ. Его также
+можно передать через `TG_LOGIN_KEY=…` или `--login-key -`. Сервис входа (`broker/`) выдаёт ключи
+приложения один раз, только для этого входа. `api_hash` на вашей машине не сохраняется. Ключи входа
+персональные, работают на 3 компьютерах, и их можно отозвать. До версии 0.37 ключ назывался
+инвайтом: `--invite` и `TG_INVITE` по-прежнему работают.
 
 Сессия хранится в Keychain macOS (сервис `tg-cli`) или в 1Password с флагом `--op-vault <vault>`.
 `telegram logout` её удаляет. На Linux сессия хранится в Secret Service (GNOME Keyring, KWallet,
@@ -291,10 +291,10 @@ tailscale funnel --bg 8787                  # или: cloudflared tunnel --url h
 Нет. `read`, `inbox` и `search` оставляют чаты непрочитанными. Отмечает только `telegram mark-read`.
 
 **Нужны ли свои API-ключи?**
-Да, с [my.telegram.org/apps](https://my.telegram.org/apps). Они бесплатные, их создание занимает минуту. С инвайтом с [better-tg-cli.com](https://better-tg-cli.com) `telegram auth --invite --qr` войдёт без своих ключей.
+Да, с [my.telegram.org/apps](https://my.telegram.org/apps). Они бесплатные, их создание занимает минуту. С ключом входа с [better-tg-cli.com](https://better-tg-cli.com/login) `telegram auth --login-key --qr` войдёт без своих ключей.
 
 **Где хранится сессия и кто видит мои сообщения?**
-Сессия лежит в Keychain macOS, в Secret Service на Linux или в 1Password. CLI общается с Telegram напрямую, аналитики нет. Кроме Telegram, он ходит только в npm (раз в день за номером версии) и в сервис инвайтов при входе. Подробнее в [PRIVACY.md](PRIVACY.md).
+Сессия лежит в Keychain macOS, в Secret Service на Linux или в 1Password. CLI общается с Telegram напрямую, аналитики нет. Кроме Telegram, он ходит только в npm (раз в день за номером версии) и в сервис входа, если вы входите по ключу входа. Подробнее в [PRIVACY.md](PRIVACY.md).
 
 **Можно ли несколько аккаунтов?**
 Да, через `TG_PROFILE`: у каждого профиля свой вход, конфиг и записи в Keychain, например `TG_PROFILE=work telegram auth --qr`. Удобное переключение аккаунтов — в [#5](https://github.com/TheVilfer/better-tg-cli/issues/5).
@@ -337,7 +337,7 @@ GitHub Releases, в npm (trusted publishing с provenance), в Homebrew-тап
 
 ## Приватность
 
-Аналитики нет. Единственный наш сервис — необязательный брокер инвайтов, и он не видит ни ваших
+Аналитики нет. Единственный наш сервис — необязательный сервис входа, и он не видит ни ваших
 сообщений, ни сессии. В [PRIVACY.md](PRIVACY.md) перечислены три хоста, с которыми общается CLI,
 и то, что он хранит локально.
 
@@ -351,8 +351,8 @@ by [SignPath.io](https://about.signpath.io), certificate by [SignPath Foundation
 
 - Коммиттеры и ревьюеры: [@TheVilfer](https://github.com/TheVilfer)
 - Утверждают каждый подписанный релиз: [@TheVilfer](https://github.com/TheVilfer)
-- Политика приватности: [PRIVACY.md](PRIVACY.md). CLI обращается только к Telegram, к брокеру
-  инвайтов при входе по инвайту и раз в день к npm-реестру за номером версии, если запущен в
+- Политика приватности: [PRIVACY.md](PRIVACY.md). CLI обращается только к Telegram, к сервису
+  входа при входе по ключу входа и раз в день к npm-реестру за номером версии, если запущен в
   терминале (отключается `TG_NO_UPDATE_CHECK=1`).
 
 ## Лицензия