Hand a bug to an agent from the chat

Gaia is testing the Timebreez import. The Reconcile step throws a red error. She screenshots it into the team group, like she always does.

Before, that screenshot waited for Colm to read it, retype it into a ticket and chase a developer. Now she replies to it with one line, and an agent works it and answers her in the same chat.

Partly works today

Why it matters to you

  • One agent, many reporters. Twenty people can report bugs to one agent role. They need no AI account, no repo access and no setup beyond linking Telegram once.
  • Nothing is retyped. The agent gets the reporter’s words, the message they replied to and the screenshot itself.
  • The loop closes where the bug was found. The group sees “picked up”, then “finished” with a verdict: a bug and its fix, not a bug and why, or can’t reproduce.
  • Nothing is explained twice. The agent also reads what happened since: notes from earlier runs, related cards, summaries from Claude Code sessions and your later replies. See What a worker reads before it starts.
  • You can check. The card holds the report, every note the agent left, the branch and the PR. The owner gets a copy when someone hands work over in a private chat.

How to do it

  1. Find the bug message or screenshot in the group.
  2. Reply to it (swipe left, or tap Reply).
  3. Send /t @timebreez-builder, using the agent’s handle from /who. Add words after the handle if you want: /t @timebreez-builder happens after carry forward too.
  4. The bot answers with the card it made. When the agent claims it, the group sees @timebreez-builder picked up: ....
  5. When it is done, the group sees finished and a Result: line with the verdict.

Use the /t form. In most groups the bot only receives commands, so a plain @timebreez-builder never reaches it. A group owner can change that in Telegram, and then the plain handle works too.

Gaia: screenshotTimebreez_work group timebreez stax Card + screenshot @timebreez-builder finished · Result: Not a bug
Gaia replies to her screenshot with /t @timebreez-builder. The card carries her words and the picture. The agent claims it, works it, and the group gets finished with a Result line.

Scenarios

The in-house tester. Gaia rehearses a customer import and hits an error at Reconcile. She replies /t @timebreez-builder to her screenshot. Twenty minutes later the group reads Result: Not a bug: the leave year is not set for this organisation. Set it in Leave settings, then reconcile. She fixes the setting and moves on. Nobody else was pulled in.

The agency client. Nadia’s studio shares a group with a client. The client posts a photo of a broken menu on their phone. Nadia replies /t @atlas-builder. The agent finds the cause, opens a PR and reports Bug: menu overlaps at 375px, fixed in PR 41. Nadia checks the preview before she tells the client.

The field team. Bob is on site with a tablet. The inspection form rejects a date. He snaps it and sends /t @forms-builder date field rejects 31/10 as the photo caption. The agent answers Cannot reproduce: 31/10/2026 saves on the current form. Which app version is the tablet on? and the question comes to Bob in Telegram.

The beta group. A founder runs a group of 30 beta users. Each bug report is one reply away from the builder role. The founder reads verdicts, not raw reports, and only steps in when the answer is a real bug that needs a product call.

What you need once

  • The group is connected to the stax and each reporter has linked Telegram. See Telegram.
  • The agent role is on the stax with a worker listening. See Connect a worker.

What works today

Step State
/t @agent as a reply, card with the quoted message and screenshot live in the product, not yet seen end to end
Agent reads the report and the screenshot on your machine live in the CLI, not yet seen end to end
Picked up and finished with a verdict, in the chat live in the product, not yet seen end to end
A plain @agent with no /t only in groups where the bot can read all messages

Now you can turn a screenshot into a verdict without retyping a word.


HeyStax Help © Hulupeep