better-tg-cli 0.25.2 → 0.27.0

package/README.md

@@ -91,6 +91,7 @@ Every channel ships the same version from one release:
 | Gemini CLI extension | skill and MCP server | `gemini extensions install https://github.com/TheVilfer/better-tg-cli` |
 | Cursor, VS Code | MCP server | [one-click buttons](#mcp-server) |
 | Grok Bot | MCP server over HTTP from your Mac | [see below](#grok-bot-remote-mcp-over-http) |
+| The CLI itself | agent skill for Claude Code, Codex, Cursor, Gemini CLI and 7 more | `telegram skill install` |
 | [skills.sh](https://skills.sh) | agent skill for any shell agent | `npx skills add TheVilfer/better-tg-cli` |
 | [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=better-tg-cli) | MCP server entry `io.github.TheVilfer/better-tg-cli` | through your MCP client |
 
@@ -121,7 +122,18 @@ grok plugin marketplace add TheVilfer/better-tg-cli && grok plugin install bette
 The skill ([`skills/better-tg-cli`](skills/better-tg-cli/SKILL.md)) teaches any agent with a shell
 (Claude Code, Codex, Cursor, Gemini CLI, OpenCode and others) to use the CLI safely. It checks the
 setup, never logs in on its own, keeps writes behind your approval, and avoids ban-prone patterns.
-Install it with the [skills](https://skills.sh) CLI:
+The CLI carries the skill and installs it itself, so it always matches your version:
+
+```bash
+telegram skill install                  # every supported agent found on this machine
+telegram skill install -a claude-code codex
+telegram skill status                   # installed, outdated, linked or missing, per agent
+```
+
+It knows Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Grok Build, OpenCode, Goose,
+Droid, Windsurf and Pi (`telegram skill status` lists the folders). Run it again after
+`telegram update` to refresh the skill. A skill folder that is a symlink is left alone unless you
+pass `--force`. For other agents, use the [skills](https://skills.sh) CLI:
 
 ```bash
 npx skills add TheVilfer/better-tg-cli          # pick agents interactively
@@ -130,6 +142,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
@@ -137,7 +155,9 @@ npx skills add TheVilfer/better-tg-cli -g -a claude-code -a codex -y
    `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.** If the maintainer gave you an invite token, you don't need your own keys.
+**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.
@@ -247,7 +267,7 @@ 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. If the maintainer gave you an invite, `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 an invite from [better-tg-cli.com](https://better-tg-cli.com), `telegram auth --invite --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).
@@ -263,6 +283,7 @@ Cloud agents can't start a program on your computer, so run the MCP server over
 
 **How do I update?**
 Run `telegram update`. It uses the same channel you installed from: Homebrew, npm or a release binary.
+If you installed the agent skill with `telegram skill install`, run that again to refresh it.
 
 ## Development
 

package/README.ru.md

@@ -90,6 +90,7 @@ npm install -g better-tg-cli               # Node >= 20
 | Расширение Gemini CLI | скилл и MCP-сервер | `gemini extensions install https://github.com/TheVilfer/better-tg-cli` |
 | Cursor, VS Code | MCP-сервер | [кнопки в один клик](#mcp-сервер) |
 | Grok Bot | MCP-сервер по HTTP с вашего Mac | [см. ниже](#grok-bot-удалённый-mcp-по-http) |
+| Сам CLI | скилл для Claude Code, Codex, Cursor, Gemini CLI и ещё 7 агентов | `telegram skill install` |
 | [skills.sh](https://skills.sh) | скилл для любого агента с шеллом | `npx skills add TheVilfer/better-tg-cli` |
 | [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=better-tg-cli) | запись MCP-сервера `io.github.TheVilfer/better-tg-cli` | через ваш MCP-клиент |
 
@@ -120,7 +121,18 @@ grok plugin marketplace add TheVilfer/better-tg-cli && grok plugin install bette
 Скилл ([`skills/better-tg-cli`](skills/better-tg-cli/SKILL.md)) учит любого агента с шеллом
 (Claude Code, Codex, Cursor, Gemini CLI, OpenCode и других) безопасно работать с CLI. Он проверяет
 установку, никогда не входит сам, держит запись под вашим подтверждением и обходит действия, за
-которые банят. Ставится через CLI [skills](https://skills.sh):
+которые банят. Скилл лежит внутри CLI, и CLI ставит его сам, поэтому версии всегда совпадают:
+
+```bash
+telegram skill install                  # во все поддерживаемые агенты на этой машине
+telegram skill install -a claude-code codex
+telegram skill status                   # по каждому агенту: стоит, устарел, симлинк или нет
+```
+
+Поддерживаются Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Grok Build, OpenCode,
+Goose, Droid, Windsurf и Pi (папки показывает `telegram skill status`). После `telegram update`
+запустите команду ещё раз, чтобы обновить скилл. Папку-симлинк команда не трогает без `--force`.
+Для остальных агентов есть CLI [skills](https://skills.sh):
 
 ```bash
 npx skills add TheVilfer/better-tg-cli          # агенты выбираются интерактивно
@@ -129,6 +141,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` и введите их. Затем на телефоне откройте Настройки → Устройства →
@@ -136,7 +154,9 @@ 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` на вашей машине не сохраняется. Инвайты персональные, число входов по ним ограничено, и
@@ -248,7 +268,7 @@ tailscale funnel --bg 8787                  # или: cloudflared tunnel --url h
 Нет. `read`, `inbox` и `search` оставляют чаты непрочитанными. Отмечает только `telegram mark-read`.
 
 **Нужны ли свои API-ключи?**
-Да, с [my.telegram.org/apps](https://my.telegram.org/apps). Они бесплатные, их создание занимает минуту. Если мейнтейнер дал вам инвайт, `telegram auth --invite --qr` войдёт без своих ключей.
+Да, с [my.telegram.org/apps](https://my.telegram.org/apps). Они бесплатные, их создание занимает минуту. С инвайтом с [better-tg-cli.com](https://better-tg-cli.com) `telegram auth --invite --qr` войдёт без своих ключей.
 
 **Где хранится сессия и кто видит мои сообщения?**
 Сессия лежит в Keychain macOS, в Secret Service на Linux или в 1Password. CLI общается с Telegram напрямую, аналитики нет. Кроме Telegram, он ходит только в npm (раз в день за номером версии) и в сервис инвайтов при входе. Подробнее в [PRIVACY.md](PRIVACY.md).
@@ -264,6 +284,7 @@ tailscale funnel --bg 8787                  # или: cloudflared tunnel --url h
 
 **Как обновиться?**
 `telegram update`. Команда обновляет тем же способом, каким CLI был установлен: Homebrew, npm или бинарник из релиза.
+Если скилл для агентов ставили через `telegram skill install`, запустите её ещё раз, чтобы обновить скилл.
 
 ## Разработка