whatisgithub

What is github-sentinel?

midudev/github-sentinel — explained in plain English

Analysis updated 2026-05-18

29TypeScriptAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A self-hosted agent that watches GitHub repos for new issues, analyzes each one with an AI model, and shows summaries, risk level, and suggested fixes on a dashboard.

Mindmap

mindmap
  root((GitHub Sentinel))
    What it does
      Poll for issues
      Analyze with AI
      Show dashboard
    Tech stack
      Bun
      TypeScript
      React
      SQLite
    Use cases
      Issue triage
      Risk scoring
      Local LLM support
    Audience
      Maintainers
      Developers
    Deployment
      Self-hosted
      Windows or macOS service

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically get a summary and risk level for every new issue on a repo you maintain.

USE CASE 2

See which source files are most likely involved in a reported bug.

USE CASE 3

Run the agent continuously on a home server or mini PC to triage issues around the clock.

USE CASE 4

Point the agent at a local, offline language model to keep issue data off the internet.

What is it built with?

TypeScriptBunReactSQLite

How does it compare?

midudev/github-sentineldavidhdev/rbp-portfoliodrakkar-softwares/polymarket-kalshi-arbitrage-bot
Stars292929
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedeveloperdesignerdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Bun as the runtime and an OpenAI-compatible language model endpoint, plus a GitHub token to poll issues.

The full README is longer than what was shown, so license terms are not confirmed here.

So what is it?

GitHub Sentinel is a self-hosted agent that monitors one or more GitHub repositories around the clock, detects newly opened issues, analyzes each one with a language model, and displays the results in a local web dashboard. It is designed to run continuously on a small machine such as a mini PC or home server running Windows or macOS. On a configurable schedule (defaulting to every 30 minutes), the agent polls the GitHub REST API for new issues and stores each one in a local SQLite database to avoid processing the same issue twice. For each new issue, it sends the text to a language model of your choice and gets back a summary, a category (bug, feature request, documentation, or question), a risk level (low, medium, or high), the source files most likely involved, and a proposed solution. The dashboard is a minimal React interface styled with terminal-inspired fonts. It supports filtering and searching through analyzed issues. The backend exposes a small API that lets you add or remove repositories to watch, trigger an immediate scan, and force re-analysis of specific issues. The project is built on Bun, a JavaScript runtime that also bundles the frontend and provides a built-in SQLite driver, so there are no external runtime dependencies beyond Bun itself. The language model endpoint is configurable to any OpenAI-compatible API, including local model servers on the same network, so all data can stay off the public internet. Service installation scripts are included for both Windows (using NSSM) and macOS (using launchd), with automatic restart on failure and log rotation. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Help me install GitHub Sentinel on my home server with Bun and configure it to watch a repo.
Prompt 2
Explain how the agent avoids reanalyzing issues it has already processed.
Prompt 3
Show me how to point GitHub Sentinel at a local OpenAI-compatible model instead of a cloud API.
Prompt 4
Walk me through setting up the Windows or macOS service installer with auto-restart.

Frequently asked questions

What is github-sentinel?

A self-hosted agent that watches GitHub repos for new issues, analyzes each one with an AI model, and shows summaries, risk level, and suggested fixes on a dashboard.

What language is github-sentinel written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, React.

What license does github-sentinel use?

The full README is longer than what was shown, so license terms are not confirmed here.

How hard is github-sentinel to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is github-sentinel for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.