explaingit

alexsjones/repo-steward

Analysis updated 2026-05-18

20PythonAudience · ops devopsComplexity · 4/5LicenseSetup · moderate

TLDR

An autonomous agent that triages issues, reviews pull requests, and monitors your project sites on a schedule, escalating only real decisions to you.

Mindmap

mindmap
  root((Repo Steward))
    What it does
      Triages issues
      Reviews pull requests
      Watches project sites
    Tech stack
      Python
      Claude Code
      systemd
    Use cases
      Automate maintainer busywork
      Live decision dashboard
      Monitor site uptime
    Audience
      Maintainers
      Ops teams

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 triage new issues and draft pull request reviews for an open source repository on a schedule.

USE CASE 2

Get a live dashboard of pending maintainer decisions instead of manually reading every PR diff.

USE CASE 3

Monitor the uptime of project websites alongside GitHub activity from one tool.

What is it built with?

PythonClaude CodesystemdGitHub CLI

How does it compare?

alexsjones/repo-stewarda-shojaei/constructdrawingaialex72-py/aria-termux
Stars202020
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity4/54/52/5
Audienceops devopsdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Linux with systemd, the GitHub CLI authenticated with push access, and a headless coding agent CLI like Claude Code.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Repo Steward is an autonomous agent that takes over the day to day busywork of maintaining an open source project. Running on a schedule or triggered with a button press, it triages incoming issues, reviews pull requests over multiple rounds, joins repository discussions, writes bug fix pull requests, and watches the uptime of your project websites, all while keeping a live dashboard of what it has done and what it plans to do next. The project is built for maintainers whose time gets eaten up copying pull request diffs into a chat window to get an opinion on them. Instead of doing that by hand, the steward runs that same loop on its own across every repository you point it at, and shows its work openly rather than just reporting that something happened. A few design choices stand out. Everything the steward writes, like a review or a reply, sits in draft mode until you flip a live toggle, so nothing is posted publicly under your name until you trust it. The steward itself never merges or closes anything on its own judgment. Only a click or a typed decision from you executes an action, and that action runs under your own GitHub login because you were the one who decided. You can also type a plain sentence describing what you want done on any pending decision, and the tool interprets it and carries it out. Installing it requires a Linux machine with a systemd user session, Python 3, the jq command line tool, and the GitHub CLI logged in with push access to your repositories. You copy a configuration file, list your repositories and limits, and run an install script, after which a local dashboard is available in your browser showing decisions that need you, pull requests ready for a final look, and what the steward intends to do on its next scheduled run. By default it runs using Claude Code as its underlying AI engine, but it can be switched to other coding agent command line tools, including local models, at install time. The project is released under the MIT License.

Copy-paste prompts

Prompt 1
Walk me through installing Repo Steward with systemd on Linux and connecting it to my GitHub repos.
Prompt 2
Explain how Repo Steward's draft mode and live toggle keep it from acting on GitHub without my approval.
Prompt 3
How do I switch Repo Steward from the default Claude Code engine to a different headless coding agent?
Prompt 4
What does Repo Steward's dashboard show me about decisions needed versus what it plans to do next tick?

Frequently asked questions

What is repo-steward?

An autonomous agent that triages issues, reviews pull requests, and monitors your project sites on a schedule, escalating only real decisions to you.

What language is repo-steward written in?

Mainly Python. The stack also includes Python, Claude Code, systemd.

What license does repo-steward use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is repo-steward to set up?

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

Who is repo-steward for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.