# arti2210/cli-telegram-remote-control architecture

> Architecture diagram of the GitHub repository arti2210/cli-telegram-remote-control, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/arti2210/cli-telegram-remote-control
- Repository: https://github.com/arti2210/cli-telegram-remote-control
- Video tour (about a minute): https://gitdiagram.com/arti2210/cli-telegram-remote-control/video

## Overview

CLI Telegram Remote Control is a single-file Telegram bot that relays user input to a compatible CLI server’s HTTP session API and returns agent replies. The main workflow is access-checked Telegram input → session selection → prompt submission and response polling → Telegram reply. Separate bot capabilities manage sessions, models, status, and usage; a terminal can attach to the same server-side session. The README documents these capabilities, while the sampled source is partial, so uncertain internal wiring is omitted.

Main entry points: [`bot.py`](https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py) (Bot handlers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_telegram["Telegram interface"]
  node_dispatch["Bot handlers<br/>[bot.py]"]
  node_access["Access control<br/>[bot.py]"]
  node_text_input["Text input<br/>[bot.py]"]
  node_media_input["Media inputs<br/>[bot.py]"]
  node_commands["Bot commands<br/>[bot.py]"]
  node_reply["Reply formatting<br/>[bot.py]"]
end

subgraph group_sessions["Session control"]
  node_lifecycle["Session lifecycle<br/>[bot.py]"]
  node_prompt["Prompt exchange<br/>[bot.py]"]
  node_model_control["Model selection<br/>[bot.py]"]
  node_usage["Status and usage<br/>[bot.py]"]
end

subgraph group_cli["CLI server integration"]
  node_http_api["HTTP API helpers<br/>[bot.py]"]
  node_cli_server{{"CLI serve API"}}
  node_terminal_attach["Terminal attach"]
end

node_user(("Telegram user"))
node_telegram_api{{"Telegram Bot API"}}

node_user -->|"sends updates"| node_telegram_api
node_telegram_api -->|"delivers updates"| node_dispatch
node_dispatch -->|"checks access"| node_access
node_dispatch -->|"dispatches text"| node_text_input
node_dispatch -->|"dispatches media"| node_media_input
node_dispatch -->|"dispatches commands"| node_commands
node_text_input -->|"ensures session"| node_lifecycle
node_text_input -->|"submits text"| node_prompt
node_media_input -->|"downloads files"| node_telegram_api
node_media_input -->|"ensures session"| node_lifecycle
node_media_input -->|"submits content"| node_prompt
node_commands -->|"manages session"| node_lifecycle
node_commands -->|"changes model"| node_model_control
node_commands -->|"gets status"| node_usage
node_lifecycle -->|"calls endpoints"| node_http_api
node_prompt -->|"sends and polls"| node_http_api
node_model_control -->|"lists models"| node_http_api
node_usage -->|"reads session data"| node_http_api
node_http_api -->|"HTTP requests"| node_cli_server
node_cli_server -->|"shares sessions"| node_terminal_attach
node_prompt -->|"returns response"| node_reply
node_reply -->|"sends replies"| node_telegram_api
node_commands -->|"sends command replies"| node_telegram_api
node_user -.->|"attaches by command"| node_terminal_attach

click node_dispatch "https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py"
click node_access "https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py"
click node_text_input "https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py"
click node_media_input "https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py"
click node_commands "https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py"
click node_reply "https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py"
click node_lifecycle "https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py"
click node_prompt "https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py"
click node_model_control "https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py"
click node_usage "https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py"
click node_http_api "https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dispatch,node_access,node_text_input,node_media_input,node_commands,node_reply,node_user toneBlue
class node_lifecycle,node_prompt,node_model_control,node_usage toneAmber
class node_http_api,node_cli_server,node_terminal_attach,node_telegram_api toneMint
```

## Components

### Telegram interface

- [Bot handlers](https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py): `bot.py`
- [Access control](https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py): `bot.py`
- [Text input](https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py): `bot.py`
- [Media inputs](https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py): `bot.py`
- [Bot commands](https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py): `bot.py`
- [Reply formatting](https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py): `bot.py`

### Session control

- [Session lifecycle](https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py): `bot.py`
- [Prompt exchange](https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py): `bot.py`
- [Model selection](https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py): `bot.py`
- [Status and usage](https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py): `bot.py`

### CLI server integration

- [HTTP API helpers](https://github.com/arti2210/cli-telegram-remote-control/blob/main/bot.py): `bot.py`
- **CLI serve API**
- **Terminal attach**

### Other components

- **Telegram user**
- **Telegram Bot API**

## Connections

- Telegram user → Telegram Bot API: sends updates
- Telegram Bot API → Bot handlers: delivers updates
- Bot handlers → Access control: checks access
- Bot handlers → Text input: dispatches text
- Bot handlers → Media inputs: dispatches media
- Bot handlers → Bot commands: dispatches commands
- Text input → Session lifecycle: ensures session
- Text input → Prompt exchange: submits text
- Media inputs → Telegram Bot API: downloads files
- Media inputs → Session lifecycle: ensures session
- Media inputs → Prompt exchange: submits content
- Bot commands → Session lifecycle: manages session
- Bot commands → Model selection: changes model
- Bot commands → Status and usage: gets status
- Session lifecycle → HTTP API helpers: calls endpoints
- Prompt exchange → HTTP API helpers: sends and polls
- Model selection → HTTP API helpers: lists models
- Status and usage → HTTP API helpers: reads session data
- HTTP API helpers → CLI serve API: HTTP requests
- CLI serve API → Terminal attach: shares sessions
- Prompt exchange → Reply formatting: returns response
- Reply formatting → Telegram Bot API: sends replies
- Bot commands → Telegram Bot API: sends command replies
- Telegram user → Terminal attach: attaches by command