Back to Landing Page
SyncItWildGuardrecon-oss
recon-oss

recon-oss

Daily LLM digest of merged PRs and open issues, personalized to your OSS contribution goals.

What it does

A CLI tool for open-source contributors. It monitors a GitHub repository's merged PRs and open issues, uses a local LLM (or Claude) to generate a daily digest, and personalizes it based on your stated contribution goals. It remembers your feedback between runs so the next digest reflects what you asked for.

Why I built it

When actively contributing to a fast-moving OSS project, you need to read 10–20 merged PRs a day just to stay oriented. I was doing this manually for CCExtractor during GSoC preparation. recon-oss automates that recon loop so you spend time contributing, not reading.

How it works

On first run, bootstraps a local SQLite database with up to 500 issues and 100 PRs via the GitHub API. Every subsequent run does a delta sync — only fetching what changed since last time. It then assembles a prompt from three memory layers: your contribution goals (motive.json), the repo state (SQLite), and your conversation history (chat.json). This is sent to a local Ollama model or Anthropic's API. The digest prints to terminal or sends via Telegram. After each run, you can give feedback that's stored and injected into the next prompt.

Tech Stack

TypeScript, Node.js, SQLite (better-sqlite3), Ollama (local LLM), Anthropic Claude API (optional), GitHub REST API, Telegram Bot API, @clack/prompts for interactive CLI.