---
title: "issue-bot: Telegram bot with Claude Code · Lázaro Santana"
description: "issue-bot: a Telegram bot that takes QA issues for a local WordPress site, agrees a plan and applies the fix with Claude Code. Node.js and grammY, open source."
url: https://lazarosantana.dev/en/projects/issue-bot/
---

personal project · open source

# A bot that fixes *QA issues*

issue-bot takes QA issues for a local WordPress site over Telegram, agrees a fix plan in chat, applies the fix with Claude Code and sends back a before and after report. I wrote all of it.

[View the code](https://github.com/Lacho00/issue-bot) [Read the step-by-step guide](https://github.com/Lacho00/issue-bot/blob/main/docs/GUIDE.md)

*github.com/Lacho00/issue-bot*

issue-bot: Telegram bot that fixes QA issues with Claude Code

**206** automated tests

**13** merged pull requests

**MIT** open source

What it is

A Telegram bot that takes a QA issue all the way to a report

My role

Idea, design, code, tests and deployment, on my own

Status

In daily use on my local WordPress sites

License

MIT, the code is on GitHub

// the bot, step by step

## A face for every step

The mascot is a robot with a bug on its antenna. Its expression follows the path of an issue, and the report draws the happy, worried or neutral one depending on the state of the issues.

issue-bot mascot thinking, with bubbles above its head

01 · detects **Thinking**

issue-bot mascot with a neutral face

02 · plans **Neutral**

issue-bot mascot with narrowed eyes, working

03 · fixes **Working**

issue-bot mascot smiling, with the issue fixed

04 · reports **Happy**

issue-bot mascot looking worried, with an issue still pending

if something is left **Worried**

// the problem

## From QA to report

A QA team sends loose issues: screenshots, forwarded text, albums. Someone has to work out which site they mean, open the code, propose a fix, apply it and prove it worked.

issue-bot walks that path with a person in charge. You forward the messages, approve the plan and get a report with the QA screenshot next to Claude’s.

01

### Detects the site

It pulls host names from the URLs in the message and looks them up in each `.wp-create.json` and in the Apache vhosts. One match opens the job; several or none show buttons to choose.

02

### Agrees a plan

It collects the messages into a batch that closes after 2 minutes or with `/plan`. Claude reads the site, proposes a plan and changes nothing until you press Approve plan.

03

### Fixes with Claude Code

It runs Claude Code headless under a strict permission policy. No commit and no push: changes stay in the working tree for you to review.

04

### Reports before and after

It renders an HTML with status KPIs and a card per issue, the QA screenshot next to Claude’s. Anything you type afterwards is a correction and starts another round.

// security

## Control before speed

The bot runs Claude Code against your sites’ files, driven by Telegram messages. I treated it as remote access to that machine.

// what the hook decides

- `git commit`*denied*
- `git push`*denied*
- `delete from the database`*denied*
- `change.claude`*denied*
- `write to the site`*sandbox*
- `network from Bash`*no network*
- `write in the plan phase`*none*

**One owner only** it ignores every other user and every other chat; the first message registers the owner

**A hook before every tool** a `PreToolUse` hook denies `git commit`, `push`, database drops and edits under `.claude` before any allow rule

**Bash in a sandbox** bwrap with no network, writing only to the site and the job folder; during the plan phase, to neither

**Ask when unsure** anything no list covers comes with Allow and Deny buttons, and a denial always wins

**Not for production** meant for local development copies, not for live sites

// by the numbers

## Project in numbers

**206** automated tests, all passing

**13** merged pull requests

**2,829** lines of JavaScript in 22 modules

**MIT** open license, the full code is on GitHub

issue-bot is a personal tool, not client work: there are no business results to report. The numbers come from the repository.

Node.js 22 grammY Claude Code Telegram Bot API MCP SDK Zod Playwright WP-CLI systemd GitHub Actions

// try it

[View the code](https://github.com/Lacho00/issue-bot) [Read the step-by-step guide](https://github.com/Lacho00/issue-bot/blob/main/docs/GUIDE.md)

[Need something like this? → AI and automation](https://lazarosantana.dev/en/services/ai-automation/)

[← all tools](https://lazarosantana.dev/en/#p-tools) personal project

// your project

## Got a project in mind?

Tell me what you need. I reply within 24 hours and, if it is a fit, you get a fixed written proposal.

[Request a quote](https://lazarosantana.dev/en/contact/#form) [See services](https://lazarosantana.dev/en/services/)
