Paul Agent Bot

PaulAgentBot

[](https://github.com/paulpwo/paul-agent-bot/actions/workflows/ci.yml) [](https://github.com/paulpwo/paul-agent-bot/actions/workflows/deploy.yml) [](https://github.com/paulpwo/paul-agent-bot/actions/workflows/release-please.yml)

A self-hosted, multi-channel AI coding agent. Mention `@paulagentbot` in a GitHub issue, send a message on Telegram, or use the web dashboard — the agent reads your code, makes changes, opens pull requests, and reports back. Powered by [Claude Code](https://claude.ai/code).

Built and maintained by [Paul Osinga](https://github.com/paulpwo).

---

What it does

• GitHub-native workflow — mention @paulagentbot in any issue or PR comment; it clones the repo, makes the changes, opens a PR, and comments the result
• Telegram chat — send a message, get code shipped; supports voice notes, /stop, and per-topic repo assignment
• Scheduled tasks — set recurring jobs in plain English ("every Monday at 9am, review open PRs")
• Web dashboard — real-time task tracking, repo management, skills editor, settings panel
• Cross-channel flows — trigger from GitHub, get notified on Telegram; trigger from Telegram, see the PR on GitHub

---

Architecture

GitHub Webhook / Telegram message
        │
        ▼
  Next.js API Route
  (HMAC-verified, deduplicated via Redis)
        │
        ▼
    BullMQ Queue  ──────────────────────────────┐
        │                                        │
        ▼                                        ▼
  Task Worker                           Cron Worker
  (spawns Claude Code)                  (node-cron)
        │
        ▼
  @anthropic-ai/claude-code
  (reads/writes code, runs commands, opens PRs)