Telegram CLI
for cmdhub.

Authenticated as authenticated account

Next steps:
- Run: telegram chat list --limit 20

{
  "tool": "telegram",
  "provider": "telegram",
  "profile": "Philip Sterne",
  "auth_mode": "private_session",
  "authenticated": true,
  "app_credentials_available": true,
  "app_credentials_source": "profile",
  "session_present": true,
  "session_valid": true,
  "provider_ready": true,
  "account": {
    "id": "{telegram-id}",
    "display_name": "Philip Sterne",
    "phone_masked": "27*****1879"
  },
  "authorization": {
    "code_required": false,
    "last_checked_at": "2026-06-29T08:45:42Z",
    "login_method": "qr",
    "login_required": false,
    "password_required": false,
    "pending_code_type": "",
    "pending_login": false,
    "phone_masked": ""
  },
  "suggested_next_step": "telegram chat list --limit 20",
  "setup_url": "https://my.telegram.org/apps",
  "credential_backend": {
    "requested": "file",
    "selected": "file",
    "secure": false,
    "fallback_active": false
  }
}

Telegram account
Name:     Philip Sterne
Phone:    27*****1879
Profile:  Philip Sterne
Provider: telegram

Next steps:
- List chats:      telegram chat list --limit 20
- Check readiness: telegram doctor

Login to Telegram with the provider-supported QR flow by default.

Use --method phone only when no already logged-in Telegram app is available. Telegram API ID/hash are application credentials, not a normal account password and not a Bot API token.

Usage:
  telegram auth login [flags]

Examples:
telegram auth login
telegram auth login --help
telegram auth login --method phone

Flags:
      --api-hash string   Telegram API hash from my.telegram.org/apps
      --api-id int        Telegram API ID from my.telegram.org/apps
  -h, --help              help for login
      --method string     Telegram login method: qr or phone (default "qr")
      --phone string      Telegram account phone number in international format

Global Flags:
      --config string    Config path override
      --cursor string    Continuation cursor
      --debug            Enable debug diagnostics
      --json             Emit JSON machine output
      --jsonl            Emit JSONL records for piping
      --limit int        Maximum items to emit (default 50)
      --no-paginate      Fetch only one page
  -o, --output string    Compatibility output mode: json|jsonl. Prefer --json or --jsonl
      --page-size int    Requested upstream page size (default 50)
      --profile string   Config/auth profile (default "default")
  -q, --quiet            Suppress non-essential diagnostics
  -v, --version          Print version information
      --view string      View mode: summary|full (default "summary")

telegram doctor: WARN
Checks: credential_backend ok, credential_security warn, profiles ok, telegram_app_credentials ok, auth ok, connectivity warn
CHECK                     STATUS  DETAIL
credential_backend        OK      using file
credential_security       WARN    credential backend stores local plaintext secrets
profiles                  OK      active profile "Philip Sterne"
telegram_app_credentials  OK      Telegram API ID/hash are available from profile
auth                      OK      Telegram private session is stored
connectivity              WARN    not checked by default to avoid sending login codes; run tele...

Next steps:
- Status:       prefer an OS keychain backend outside isolated test accounts
- Capabilities: telegram capabilities

Messages (2 total)
MARKER  CHAT_TITLE      TEXT                                                                           DATE
m1      Saved Messages  cmdhub-{token} saved messages roundtrip  7d ago
m2      Saved Messages  cmdhub-{token} cleanup candidate       9d ago

Next steps:
- Open:         telegram message get m1
- Search:       telegram message search --query <text>
- List chats:   telegram chat list --limit 20
- Capabilities: telegram capabilities

Get message m1: cmdhub-{token} saved messages roundtrip
Field  Value
-----  -----
Ref    m1
Type   message
Title  cmdhub-{token} saved messages roundtrip
When   2026-06-29T07:37:31Z

Next steps:
- Run:             telegram saved list --limit 20
- Open:            telegram message get m1
- List chats:      telegram chat list --limit 20
- Search messages: telegram message search --query <text>

Message send preview
Chat:   c1  Saved Messages
From:   You
Text:   cmdhub-{token}
Status: not sent

To send this message, rerun with --yes.

Next steps:
- Send exactly this message: telegram message send --chat c1 --text "cmdhub-{token}" --yes
- Inspect destination first: telegram chat get c1

Message reply preview
Text:   cmdhub-{token}
Status: not sent

Next steps:
- Apply exactly this preview: telegram message reply m1 --text "cmdhub-{token}" --yes

Message delete preview
Text:   Saved Messages
Status: not changed

Next steps:
- Apply exactly this preview: telegram message delete m1 --yes