Hermes Atlas
Messaging bridges & gateways

Hermes Telegram UX

pler1y/hermes-telegram-ux

Plugin that shows one live, temporary progress message in Telegram while Hermes Agent works

In short

Hermes Telegram UX is a Hermes Agent plugin that shows task-aware, temporary progress in Telegram. One status message explains what is happening, follows real tool actions and results, and is removed when Hermes sends its final answer.

What Hermes Telegram UX does

Hermes Telegram UX edits a single Telegram message as a task advances, for example from thinking to searching, reviewing sources and preparing the final answer. The status follows real tool events and recognized tool results, such as search counts, returned weather fields, missing files and failures. Recovery is shown only after a real subsequent attempt, and partial failures stay qualified. For substantial work, a telegram_ux_update tool lets the model supply concrete stages that tool events cannot express, such as comparing sources.

No timer invents stages, edits are throttled, duplicates are suppressed and cleanup is bounded. Status language switches between Chinese and English based on the current message. The plugin deliberately has no completion cards, buttons, welcome pages, settings panels or /tgux command, and you disable it through Hermes when you do not need progress. Version 2.1.0 is built only on the public Plugin API, and the install pins a commit SHA resolved from the v2.1.0 tag before running hermes plugins validate and doctor.

Key features

  • One edited status message instead of a stream of notifications
  • Status driven by real tool actions and recognized tool results
  • telegram_ux_update tool for concrete milestones on larger tasks
  • Throttled edits, duplicate suppression and bounded cleanup
  • Automatic Chinese or English status language
  • Built only on the public Hermes Plugin API

When to use it

  • Seeing what Hermes is doing while a long Telegram task runs
  • Knowing when a search or file lookup failed before the final answer arrives
  • Keeping a chat clean because the status message is removed afterward

Who it is for: Hermes Agent users who talk to their agent through Telegram and want clear progress feedback during long tasks.

How it fits with Hermes Agent

It is a Hermes plugin for the Telegram gateway, installed with hermes plugins install and enabled as hermes-telegram-ux-catalog.

Requirements: Hermes 0.21.0 or newer with working Telegram; the verified baseline is Hermes 0.21.3

FAQ

What is Hermes Telegram UX?

Hermes Telegram UX is a Hermes Agent plugin that shows a single temporary progress message in Telegram while a task runs. It follows real tool actions and is cleaned up when the final answer is sent.

Does Hermes Telegram UX work with Hermes Agent?

Yes. It is a plugin built on the public Hermes Plugin API and requires Hermes 0.21.0 or newer with working Telegram.

Is Hermes Telegram UX free and open source?

Yes. The repository is released under the MIT license.

Similar messaging for Hermes Agent

All messaging

Related guides: How to run Hermes Agent securely · Run multiple Hermes agents with profiles