Introduction

cligram is a Telegram client that runs in your terminal.

Last updated: April 19, 2026

# Introduction

**cligram** is a Telegram client that runs in your terminal.

![cligram demo](/demo.gif)

- Currently supports chatting with personal chats, channels, and has beta support for bots.
- Lightweight, minimalistic, and terminal-based for basic messaging tasks.
- Not intended to replace GUI Telegram clients—some advanced features are missing.

### Limitations

- **Bot Interaction:** Supported (beta).
- **Media Management:** No advanced media viewing/editing.
- **Voice/Video Calls:** Not supported.
- **Rich Media Previews:** Not displayed.
- **Group Support:** Supported, but you can only write in group chats. You cannot see the full member list.
- **Multi-Account Support:** Only one account at a time.

For a complete Telegram experience, use the official desktop or mobile apps.

<div style="opacity: 0.7; font-size: 0.7em; margin-top: 50px;">
  <strong>Use at your own risk.</strong> This application breaks Telegram's <a href="https://core.telegram.org/api/terms" target="_blank">developer TOS</a> to implement "ghost mode" features (anonymous story viewing and message reading). Users are solely responsible for compliance.
</div>

cligram is a Telegram client that runs in your terminal.

cligram demo

Currently supports chatting with personal chats, channels, and has beta support for bots.
Lightweight, minimalistic, and terminal-based for basic messaging tasks.
Not intended to replace GUI Telegram clients—some advanced features are missing.

Limitations

Bot Interaction: Supported (beta).
Media Management: No advanced media viewing/editing.
Voice/Video Calls: Not supported.
Rich Media Previews: Not displayed.
Group Support: Supported, but you can only write in group chats. You cannot see the full member list.
Multi-Account Support: Only one account at a time.

For a complete Telegram experience, use the official desktop or mobile apps.

Use at your own risk. This application breaks Telegram's developer TOS to implement "ghost mode" features (anonymous story viewing and message reading). Users are solely responsible for compliance.