Telegram Topic Mode

July 6, 2026 ยท View on GitHub

Telegram topic mode lets a single Telegram forum supergroup host multiple Codeg sessions, with each session bound to one Telegram topic.

Requirements

  • The Telegram chat must be a forum-enabled supergroup.
  • The bot must be a member of that supergroup.
  • To let Codeg create and rename topics, the bot must be an administrator with topic management permission.
  • The Codeg Telegram channel chat_id must point to the intended supergroup. Updates from any other chat are ignored.

Enable Topic Mode

  1. Open Codeg settings and create or edit a Telegram chat channel.
  2. Set the Telegram bot token and the forum supergroup chat_id.
  3. Enable Topic mode.
  4. Save the channel and make sure it is connected.

Existing Telegram channels keep the old behavior until topic mode is enabled.

Usage

  • In the General topic, send /task <description> to create a new Telegram topic and start a new Codeg session there.
  • In a manually created topic, send /task <description> to start and bind a new session to that topic.
  • In a manually created topic, send /resume <id> to bind an existing session to that topic.
  • In a bound topic, plain text is treated as a follow-up for that topic's session.
  • In the General topic, plain text is ignored. Use /task <description> explicitly to avoid accidental bot triggers in group chat.
  • /sessions, /cancel, /approve, /deny, /folder, and /agent keep their existing meanings. In topic mode, session-specific commands resolve the current session from the Telegram topic binding.
  • /folder and /agent without arguments show Telegram inline buttons when Telegram supports them.

Title Sync

When Codeg updates a conversation title, Codeg attempts to rename the bound Telegram topic. This is best-effort: if Telegram rejects the rename or the bot lacks permission, the Codeg conversation still updates.

Notes

  • Topic mode is Telegram-only in this release. Lark/Feishu and Weixin behavior is unchanged.
  • Codeg does not automatically cancel a session when a Telegram topic is closed or deleted.
  • Historical sessions are not automatically migrated into Telegram topics.