better-tg-cli 0.36.0 → 0.37.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.
- package/README.es.md +15 -14
- package/README.md +14 -13
- package/README.ru.md +14 -14
- package/dist/telegram.mjs +1 -1
- package/package.json +1 -1
- package/skills/better-tg-cli/SKILL.md +1 -1
- package/skills/better-tg-cli/reference.md +2 -2
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "better-tg-cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.37.0",
|
|
4
4
|
"description": "Telegram for your terminal and your AI agents: read, search, send and press bot buttons on your own account. MCP server included.",
|
|
5
5
|
"mcpName": "io.github.TheVilfer/better-tg-cli",
|
|
6
6
|
"keywords": [
|
|
@@ -14,7 +14,7 @@ telegram help-all -g read >/dev/null && telegram check
|
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
- **`telegram` is missing, or it has no `help-all`.** A different program is installed under that name. Ask the user before installing anything, then run `brew install thevilfer/tap/better-tg-cli` (macOS or Linux), `scoop install better-tg-cli` after `scoop bucket add thevilfer https://github.com/TheVilfer/scoop-bucket` (Windows), or `npm install -g better-tg-cli` (Node 20 or newer, any OS). Never install `@skillhq/telegram`: it is an old build, and bot replies come back as `(no text)`.
|
|
17
|
-
- **"Not configured" or "Not authenticated".** Run `telegram onboard --json` (in the background if your tool times out before ~15 minutes). It opens a page on 127.0.0.1 where the user gets
|
|
17
|
+
- **"Not configured" or "Not authenticated".** Run `telegram onboard --json` (in the background if your tool times out before ~15 minutes). It opens a page on 127.0.0.1 where the user gets a login key or enters their own API keys, scans a QR code and types their 2FA password. You never see any of that. Tell the user the page is open (relay the `url` event if the browser didn't open), wait for the `done` event, then confirm with `telegram whoami`. Never run `telegram auth` yourself. Never ask for a login code, 2FA password, login key or api_hash in chat, and never fill in the onboarding page yourself. If the user is on SSH or `onboard` can't open a page, ask them to run `telegram auth --qr` in their own terminal.
|
|
18
18
|
|
|
19
19
|
Before you use an unfamiliar flag, run `telegram help-all -g <word>`. It is generated from the code, so it is always current. For behaviour details (threads, bot buttons, sync, JSON shapes, errors), read `reference.md` next to this file.
|
|
20
20
|
|
|
@@ -142,13 +142,13 @@ matches titles.
|
|
|
142
142
|
## Troubleshooting
|
|
143
143
|
|
|
144
144
|
- `Not configured`: run `telegram onboard --json`. It serves a one-shot page on 127.0.0.1 (random
|
|
145
|
-
secret path, closes when done, `--timeout` 15 min by default) where the user gets
|
|
145
|
+
secret path, closes when done, `--timeout` 15 min by default) where the user gets a login key from
|
|
146
146
|
better-tg-cli.com (it comes back to the page by itself), or enters their own keys, then scans a QR
|
|
147
147
|
code and types their 2FA password. Events: `url`, `waiting_invite`, `waiting_scan`, `need_password`,
|
|
148
148
|
`done` (exit 0), `error`, `timeout` (exit 1); `already_logged_in` exits 0 without changes.
|
|
149
149
|
`--no-open` only prints the URL. You never get tokens, codes or passwords, and you must not ask
|
|
150
150
|
for them or fill in the page. Without a browser on this machine (SSH), the user runs
|
|
151
|
-
`telegram auth --qr` (own keys) or `telegram auth --
|
|
151
|
+
`telegram auth --qr` (own keys) or `telegram auth --login-key --qr` in their terminal; that is
|
|
152
152
|
interactive, so never run it for them. `--qr` logs in by scanning a QR code in the Telegram app instead of
|
|
153
153
|
typing a code (`TG_QR_INVERT=1` for light terminals).
|
|
154
154
|
|