cc-changelog-monitor

# cc-changelog-monitor

Monitors `@anthropic-ai/claude-code` on npm and sends Telegram alerts when a new version is detected, including a diff summary of what changed between versions.

**Zero AI credits used during monitoring** — pure bash + curl + jq.

## Quick Start

### 1. Setup (one-time)

```bash
bash ~/clawd/skills/cc-changelog-monitor/scripts/setup.sh
```

This will:
- Auto-detect your Telegram bot token from OpenClaw config
- Ask for your Telegram chat ID (defaults to your personal ID)
- Initialize the version tracker at the current Claude Code version
- Make scripts executable

### 2. Manual run

```bash
bash ~/clawd/skills/cc-changelog-monitor/scripts/monitor.sh
```

Output when no new version:
```
✓ Claude Code is at v2.1.69 — no change.
```

Output when new version detected:
```
🔔 New version detected: v2.1.69 → v2.1.70
📦 Downloading @anthropic-ai/claude-code@2.1.70...
✅ Telegram alert sent!
✅ Saved v2.1.70 as current version.
```

### 3. Add to OpenClaw Cron

See `cron-payload.md` for the exact payload to set up automatic monitoring every 2 hours.

## How It Works

1. **Polls npm registry** — `curl https://registry.npmjs.org/@anthropic-ai/claude-code/latest`
2. **Compares** with `~/.cc-changelog-version` (stored version)
3. **If new version**: downloads the tarball, extracts it, diffs against previous
4. **Sends Telegram alert** with version info + diff summary
5. **Saves new version** to disk

## Config

Credentials stored in `~/.cc-changelog-config`:

```bash
TELEGRAM_BOT_TOKEN="your-bot-token"
TELEGRAM_CHAT_ID="your-chat-id"
```

## Files Created by Monitor

- `~/.cc-changelog-version` — tracks the last seen version
- `~/.cc-changelog-config` — Telegram credentials
- `~/clawd/projects/cc-changelog/{version}/` — extracted npm packages for diffing

## Force Test Alert

```bash
# Reset version to trigger an alert
echo "0.0.0" > ~/.cc-changelog-version
bash ~/clawd/skills/cc-changelog-monitor/scripts/monitor.sh
```

## Skill Invocation (from OpenCla...

# cc-changelog-monitor

> 🤖 Get Telegram alerts the moment Claude Code ships a new version — with a diff of what changed.

**Zero AI credits used during monitoring.** Pure bash + curl + jq. Runs as an OpenClaw cron job every 2 hours.

---

## What It Does

- Polls the npm registry for `@anthropic-ai/claude-code` every 2 hours
- Detects new versions by comparing with the last seen version
- Downloads the npm tarball and diffs it against the previous version
- Sends a Telegram alert with:
  - Old vs new version numbers
  - Count of changed/new files
  - Brief diff summary
  - Link to npm package page

**Example alert:**

```
🤖 Claude Code v2.1.70 released!

📌 Previous: v2.1.69
📝 Changed files: 3
✨ New files: 1
🕐 Published: 2026-03-06T10:23:11.000Z
🔗 https://www.npmjs.com/package/@anthropic-ai/claude-code

Diff summary:
Files dist/common/utils.js and dist/common/utils.js differ
Only in v2.1.70: dist/new-feature.js

_Monitored by OpenClaw cc-changelog-monitor_
```

---

## Prerequisites

- [OpenClaw](https://openclaw.ai) installed (for cron scheduling)
- A Telegram bot token (create one via [@BotFather](https://t.me/BotFather))
- `curl`, `jq`, `npm` installed on your machine

---

## Quick Start

**1. Clone/install the skill:**

```bash
# If using ClawdHub
clawdhub install cc-changelog-monitor

# Or clone directly
git clone https://github.com/antoinersx/cc-changelog-monitor ~/clawd/skills/cc-changelog-monitor
```

**2. Run setup:**

```bash
bash ~/clawd/skills/cc-changelog-monitor/scripts/setup.sh
```

The setup script will:
- Auto-detect your Telegram bot token from OpenClaw config (if available)
- Ask for your Telegram chat ID
- Initialize the version tracker at the current Claude Code version
- Print instructions for adding the cron job

**3. Add the cron in OpenClaw:**

See [`cron-payload.md`](./cron-payload.md) for the exact payload to paste into OpenClaw.

---

## How It Works (No AI Credits)

Most monitoring tools use LLMs to summarize changes — this one d...