Gator 🐊 (RSS Aggregator CLI)

Gator is a multi-user RSS feed aggregator written in TypeScript.

Requirements

• Node.js v22.15.0 (via nvm)
• PostgreSQL 16+
• Ubuntu / WSL or Linux/macOS

Setup

Install dependencies:

npm install

Create config file:

~/.gatorconfig.json

Example:

{ "db_url": "postgres://postgres:postgres@localhost:5432/gator?sslmode=disable" }

Run migrations:

npx drizzle-kit generate npx drizzle-kit migrate

Example Commands

Register user: npm run start register lane

Add feed: npm run start addfeed "Hacker News" "https://news.ycombinator.com/rss"

Run aggregator: npm run start agg 30s

Browse posts: npm run start browse 10

Stop aggregator with Ctrl+C.