I wanted arrow keys, raw speed, and zero distractions.

So I built Telegram Terminal Lite — a minimal Python-based Telegram client that lets me browse chats, groups, channels, bots, and recent messages directly inside the terminal using a clean interactive CLI.

Why build this when Telegram already exists?

Because modern apps are overloaded.

Sometimes I don’t want notifications, animations, sidebars, stickers, recommendations, floating buttons, and ten tabs fighting for attention.

I want:

• open terminal

• authenticate

• choose chat

• read messages

• exit

That’s it.

What Telegram Terminal Lite actually does

The project uses:

• telethon for Telegram API communication

• questionary for keyboard-based navigation

• rich for terminal rendering

This makes the terminal feel surprisingly usable for messaging workflows.

View telegram-terminal-lite on GitHub

Features

• Browse Users

• Browse Groups

• Browse Channels

• Browse Bots

• Open any chat

• Read latest 20 messages

• Navigate fully with arrow keys

Why terminal instead of GUI?

Because terminal gives:

• lower memory usage

• faster startup

• no visual noise

• easier scripting later

This is especially useful if you already live inside shell sessions.

Internal structure

The project is split cleanly:

• main.py → controls app flow

• auth.py → handles Telegram login/session

• chat_loader.py → loads dialogs and categorizes them

• ui.py → renders menus and messages

That separation made debugging much easier while keeping the MVP small.

First engineering challenge

Telegram authentication is easy once.

Reliable session handling is where it starts becoming real.

The moment sessions break, the whole CLI becomes annoying.

So authentication had to feel invisible after first login.

Why this project matters beyond Telegram

This is not only a Telegram client.

It is a pattern:

take an everyday GUI workflow and compress it into terminal-native interaction.

That same idea can be reused for:

• email

• dashboards

• internal tools

• monitoring systems

What comes next

Possible next versions:

• send messages

• search chats

• message filters

• file preview

• command shortcuts

Repo

View telegram-terminal-lite on GitHub

Closing thought

A lot of software becomes useful when you remove features, not when you add them.

This project started with one question:

How little Telegram can exist and still remain useful?