Sign in once. Keep working.
indexit uses Telegramβs user API. You need your own TELEGRAM_API_ID and TELEGRAM_API_HASH, plus an existing Telegram account. Follow the quick start to create the credentials.
QR login
indexit telegram auth login --qrIn Telegram on your phone, open Settings β Devices β Link Desktop Device and scan the QR in your terminal. The QR refreshes automatically when it expires. If the account uses a cloud password (2FA), indexit asks for it after confirmation.
QR login is useful when a phone code does not arrive. It needs a device that is already signed in.
Phone-code login
indexit telegram auth loginEnter your phone number, the code, and your 2FA password if requested. The prompt names the delivery channel Telegram selected. It offers a resend only when Telegram supplies another channel.
If no code arrives, type qr at the code prompt to switch to QR login.
Check or end the session
indexit telegram auth status
indexit telegram auth logoutstatus reports the session path, authorization state, and available account/DC information, then the peer cache path and the account the cache belongs to. With an existing session, it connects to Telegram to check authorization.
logout attempts to revoke the Telegram session and removes the local session file. If the network request fails, local removal can still occur; use Telegramβs Devices screen to revoke a remaining remote session. Logout does not delete your exports or peer cache: signing in again as the same account keeps the cache, and another account never uses it (see below).
Where the files live
| File | Default location |
|---|---|
| Session | ~/.config/indexit/telegram/session.json |
| Peer cache | ~/.cache/indexit/telegram/peers.json |
XDG_CONFIG_HOME and XDG_CACHE_HOME replace the respective base directories when set, including on macOS.
The peer cache holds the addresses Telegram issued to one account, which are worthless to any other, so it records the account it belongs to. Before a command uses the cache, indexit checks that the account of the session is that account. While the session is unchanged, the check costs no request; after a new login, one request confirms the account. If the cache belongs to another account, or records none, as caches written by earlier versions do, the command starts with an empty cache and warns the peer cache belongs to another account or records no account; run fetch dialogs to refill it. If indexit cannot tell the account, the command runs without the cache and leaves the file as it was.
The session grants access to your account. Keep it private. On macOS and Linux, an existing session file must have permissions 0600.
Use separate account files
You can explicitly select a session and cache for each command:
indexit telegram --session ./work/session.json \
--peer-cache ./work/peers.json auth login --qr
indexit telegram --session ./work/session.json \
--peer-cache ./work/peers.json fetch dialogsKeep the same pair together on later runs. Two accounts sharing one cache file empty it on every switch. v0.4.1 has no account registry or automatic multi-account orchestration.
New sessions identify the device as indexit. The application name shown by Telegram comes from your API application registration.