ps-bot-telegram

name	ps:bot-telegram
description	Set up and run a Telegram bot that lets you chat with Claude Code from your phone — summarize Slack threads, answer threads, summarize YouTube/Medium/Jira, and ask questions about your codebase. Use when the user runs /ps:bot-telegram or asks to set up a Telegram bot.
argument-hint	["--setup | --start | --stop | --status"]
allowed-tools	["Bash","Read","Write"]

Telegram Bot Setup & Manager

Arguments: $ARGUMENTS

---

Step 0 — Bootstrap scripts if missing

ls "$HOME/.local/share/personal-skills/scripts/bot/telegram_bot.py" 2>/dev/null || \
  curl -fsSL https://raw.githubusercontent.com/minhtranin/personal-skills/main/install.sh | bash

---

Step 1 — Parse intent from arguments

• No args or --setup → run full setup flow (Steps 2–5)
• --start → start the bot (Step 6)
• --stop → stop the bot (Step 7)
• --status → show bot status (Step 8)

---

Step 2 — Check dependencies

uv run --with "python-telegram-bot>=20.0" --with anthropic python3 -c "import telegram; import anthropic; print('ok')" 2>/dev/null || echo "missing"

If missing, install:

bash "$HOME/.local/share/personal-skills/scripts/bot/setup.sh"

---

Step 3 — Check if already configured

cat "$HOME/.local/share/personal-skills/bot-config.json" 2>/dev/null || echo "not configured"

If already configured, show:

✓ Bot already configured.
  Token  : <first 10 chars>...
  User ID: <id>

Run with --start to launch, or continue to reconfigure.

Ask: "Reconfigure? (y/n)" — if n, skip to Step 6.

---

Step 4 — Get Telegram bot token

Show the user:

To create a Telegram bot:

1. Open Telegram and message @BotFather
2. Send: /newbot
3. Follow prompts — choose a name and username (e.g. "MyPersonalBot", "mypersonal_bot")
4. BotFather will give you a token like: 7123456789:AAF...

Paste your bot token here:

Wait for the token input. Validate it looks like \d+:[\w-]{35,}.

---

Step 5 — Get Telegram user ID

Show the user:

To get your Telegram user ID:

1. Open Telegram and message @userinfobot
2. It will reply with your User ID (a number like 123456789)

Paste your Telegram User ID here:

Wait for the user ID. Then save config:

uv run --with "python-telegram-bot>=20.0" --with anthropic \
  python3 "$HOME/.local/share/personal-skills/scripts/bot/telegram_bot.py" \
  --token "<TOKEN>" \
  --user-id <USER_ID> \
  --setup

Show output. If success, continue to Step 6.

---

Step 6 — Start the bot

Check if already running:

pgrep -f "telegram_bot.py" && echo "running" || echo "stopped"

If running:

✓ Bot is already running (PID: <pid>).
  Send a message to your bot on Telegram to test it.

Stop here.

If stopped, start in background:

nohup uv run --with "python-telegram-bot>=20.0" --with anthropic \
  python3 "$HOME/.local/share/personal-skills/scripts/bot/telegram_bot.py" \
  > "$HOME/.local/share/personal-skills/bot.log" 2>&1 &
echo "PID: $!"

Wait 2 seconds, then verify:

sleep 2 && pgrep -f "telegram_bot.py" && echo "ok" || echo "failed"

If ok, show:

✓ Telegram bot is running!

Open Telegram and message your bot. Try:
  • "summarize this slack thread: <url>"
  • "answer this slack thread: <url>"
  • "summarize this video: <youtube-url>"
  • "what does the auth module do in my codebase?"
  • /clear  — reset conversation

Logs: tail -f ~/.local/share/personal-skills/bot.log

If failed, show the last 20 lines of the log and stop:

tail -20 "$HOME/.local/share/personal-skills/bot.log"

---

Step 7 — Stop the bot (--stop)

pkill -f "telegram_bot.py" && echo "stopped" || echo "not running"

Show result.

---

Step 8 — Status (--status)

pgrep -f "telegram_bot.py" && echo "running" || echo "stopped"

tail -20 "$HOME/.local/share/personal-skills/bot.log" 2>/dev/null || echo "(no log)"

cat "$HOME/.local/share/personal-skills/bot-config.json" 2>/dev/null | \
  python3 -c "import json,sys; d=json.load(sys.stdin); print(f'Token: {d[\"token\"][:12]}...\nUser ID: {d[\"user_id\"]}')" \
  2>/dev/null || echo "Not configured"

Show a summary of status, PID, and last log lines.

---

What the bot can do

When running, send messages to your Telegram bot:

You say	Bot does
<slack-thread-url>	Summarizes the thread
answer this: <slack-url>	Researches codebase + drafts reply
<youtube-url>	Summarizes the video
<medium-url>	Summarizes the article
PROJ-123 or <jira-url>	Summarizes the Jira issue
Any question	Answers using Claude + your codebase
/clear	Resets conversation history

The bot remembers conversation context (last 20 turns) so you can follow up naturally.