# alvin-bot

> Alvin Bot — Your personal AI agent on Telegram, WhatsApp, Discord, Signal, and Web.

- **URL**: https://www.freshcrate.ai/projects/alvin-bot
- **Author**: alvbln
- **Category**: AI Agents
- **Latest version**: `v4.25.1` (2026-05-13)
- **License**: MIT
- **Source**: https://github.com/alvbln/Alvin-Bot
- **Language**: TypeScript
- **Registry**: npm (`alvin-bot`)
- **Tags**: `agent`, `ai`, `bot`, `claude`, `gpt`, `llm`, `multi-model`, `npm`, `telegram`

## Description

Alvin Bot — Your personal AI agent on Telegram, WhatsApp, Discord, Signal, and Web.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v4.25.1` | 2026-05-13 | High | ## Fix: silent PM2 → launchd migration leak  If you migrated alvin-bot from PM2 to launchd at any point in the past, PM2 may have been silently resurrecting alvin-bot on every login from a stale `~/.pm2/dump.pm2` — fighting your launchd-managed bot for the same Telegram `BOT_TOKEN` and surfacing eventually as `409 Conflict: terminated by other getUpdates request` errors. This release closes that gap.  ### Root cause  `alvin-bot launchd install` already called `pm2 delete alvin-bot` to remove the |
| `v4.19.2` | 2026-04-24 | High | ## 🐛 Fixes  ### Workspace switch produced `(no response)` cascade  After v4.19.1 shipped, a `/workspace <name>` or `/dir <path>` switch could still produce broken responses — but this time NOT empty streams. Claude replied with literal text like `(no response)\n\nUser: Hallo`, and each follow-up turn got worse.  **Root cause.** v4.19.1's cwd-change reset set `session.lastSdkHistoryIndex = -1`. That value is consumed by `buildBridgeMessage()` in `handlers/message.ts`, which is designed for the O |
| `4.18.1` | 2026-04-21 | Low | Imported from npm (4.18.1) |
| `v4.18.1` | 2026-04-20 | High | Adds automated pre-publish PII scan. See CHANGELOG for details. |
| `v4.18.1` | 2026-04-20 | High | Adds automated pre-publish PII scan. See CHANGELOG for details. |
| `v4.18.1` | 2026-04-20 | High | Adds automated pre-publish PII scan. See CHANGELOG for details. |
| `v4.18.0` | 2026-04-20 | High | Completes the audit work from 4.17.0.  **Performance (hot path):** - User profiles cached in memory + debounced writes (no more 2 sync fs ops per message) - Embeddings index cached with mtime invalidation (previously re-read on every query) - Skills no longer force-reload every 5min (fs.watch already handles hot-reload)  **Hardening:** - Sub-agents map capped at 1000 with oldest-first eviction of delivered entries - Async-agent pending map capped at 500 - Browser gateway + MCP subprocess stderr |
| `v4.17.0` | 2026-04-20 | High | ## Hardening: long-running stability audit + leak fixes  **Fixes:** - WhatsApp event-listener leak on reconnect (memory + duplicate messages) - CDP file-descriptor leak on Chromium bootstrap - Heartbeat + auto-update timers now properly cleaned up on shutdown  ## New: /cleanup feature  Automatic daily cleanup of transient files (logs, screenshots, old subagent outputs, temp media). Memory, assets, cron jobs and workspaces stay untouched.  - `/cleanup` — show policy - `/cleanup run` — trigger man |
| `v4.16.1` | 2026-04-20 | High | After a successful `/update`, the bot now sends a short summary of what changed in the new version. Pulled from CHANGELOG.md, max 5 bullets, Telegram-friendly.  See CHANGELOG.md for details. |
| `v4.16.0` | 2026-04-20 | High | ## Feature: bot-owned CDP Chromium — no more hub dependency  **New:** - `src/services/cdp-bootstrap.ts` — spawns Playwright's bundled Chromium (no conflict with user Chrome) - `alvin-bot browser` CLI subcommand — start/stop/goto/shot/eval/tabs/doctor, with self-healing - `browser-manager` rewired — CDP strategy works on every install, no external dependency  **First-run setup:** `npx playwright install chromium`  **Note:** All versions below 4.16.0 have been deprecated as part of a privacy/PII c |

## Dependency audit

- **Score**: 98/100
- **Total deps**: 22
- **Resolved**: 22
- **Unresolved**: 0
- **License conflicts**: 0
- **Warnings**: 1
- **Scanned**: 2026-05-18

## Citation

- HTML: https://www.freshcrate.ai/projects/alvin-bot
- Markdown: https://www.freshcrate.ai/projects/alvin-bot.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/alvin-bot/deps

_Generated by freshcrate.ai. Indexes npm releases for AI-agent ecosystem packages._