Changes

Quick Start

Requirements: Bun 1.3+, SQLite (bundled with Bun), a shell.

Clone and install:

git clone https://github.com/iannuttall/changes.git

cd changes

bun install

Setup env and database:

bun setup:local

Run the service and TUI (local dev):

bun dev

bun changes

Features

• Monitors: webpages, APIs (JSON), Markdown, XML/Atom feeds
• HTML→Markdown conversion for stable diffing
• AI summaries (optional)
  • Provider: Droid CLI (no API keys) or AI SDK (Anthropic/OpenAI/Google)
  • Configure in TUI → Settings (provider/model, verify keys)
• Notifications: Telegram
• TUI over SSH; API is local and used only by the TUI
• SQLite storage; easy to run on a small VPS
• Parallel background checks with per‑monitor locking
• 5 MB max fetch size (oversize pages are skipped)
• Retention defaults: keep last 20 snapshots and 20 changes per monitor (adjust in TUI → Settings → Retention)

TUI Overview

Start:

bun changes

• Monitors: Add → List → Detail → Link notification channel
• Settings: Choose AI provider/model, verify keys, enable/disable summaries
• Controls: ↑/↓ to navigate, Enter to select, ESC/← to go back, q to quit

Local Development

bun dev

bun typecheck

bun test

bun build

Deployed to a VPS

Create and deploy in one flow:

bun setup:vps

Prompts include:

• Hetzner API key
• Server name
• Region
• Server size
• Install path
• Login key (SSH key)
• GitHub auto‑deploy (optional)

After it finishes:

• The app runs on the server.
• On your computer, open the dashboard with:

bun changes -