Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 13 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,22 +19,30 @@
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/GodsBoy/repokeeper/pulls)
![Maintained by RepoKeeper](https://img.shields.io/badge/maintained%20by-RepoKeeper-blue)

[Getting Started](#quick-start) · [Features](#what-repokeeper-does) · [Deploy to VPS](#production-deployment) · [Multi-Repo](#multi-repo-configuration) · [Contributing](#contributing)
[Getting Started](#quick-start) · [Features](#what-repokeeper-does) · [Try it live](#interactive-playground) · [Deploy to VPS](#production-deployment) · [Multi-Repo](#multi-repo-configuration) · [Contributing](#contributing)

[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy)

</div>

---

![RepoKeeper Hero](docs/images/repokeeper-hero.png)
![RepoKeeper Demo](docs/images/repokeeper-demo.gif)

## Demo

See [demo/demo.cast](demo/demo.cast) — play with: `asciinema play demo/demo.cast`

> **Live demo:** This repository is maintained by RepoKeeper itself — every issue, PR, and review goes through the same pipeline you can deploy in minutes.

## Interactive Playground

**Try it live** — paste a GitHub issue or PR diff and see RepoKeeper's AI in action, no deployment required.

Once running, visit `http://your-server:3001/playground` to try issue triage and PR summarisation instantly.

Set `attribution.playgroundUrl` in your config to link the playground from every AI-generated comment.

## The Problem

Maintainers are drowning. AI-generated pull requests, duplicate issues, low-effort bug reports, and community questions pile up faster than any human can triage them. In 2026, the average popular open source repo receives more noise than signal — and maintainer burnout is at an all-time high.
Expand Down Expand Up @@ -191,6 +199,8 @@ All configuration lives in `repokeeper.config.ts`:
| `codeReview.focus` | `string[]` | `["security", "performance", "test-coverage", "breaking-changes"]` | Review focus areas |
| `codeReview.maxContextFiles` | `number` | `5` | Max dependency files to include per changed file |
| `codeReview.minDiffLines` | `number` | `10` | Minimum added lines to trigger review |
| `attribution.enabled` | `boolean` | `true` | Add "Powered by RepoKeeper" footer to AI comments |
| `attribution.playgroundUrl` | `string` | — | Absolute URL to your playground (adds "Try it live" link to footer) |
| `port` | `number` | `3001` | Port for the webhook server |

## Per-Repository YAML Config
Expand Down Expand Up @@ -269,6 +279,7 @@ The code review feature works with all three AI providers. Use Ollama for comple
┌──────────▼──────────┐
│ Express Server │
│ /webhook │
│ /playground │
│ /health │
│ /metrics │
└──────────┬──────────┘
Expand Down
Binary file added docs/images/repokeeper-demo.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 2 additions & 0 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -38,8 +38,10 @@
"@types/express": "^5.0.0",
"@types/js-yaml": "^4.0.9",
"@types/node": "^22.0.0",
"@types/supertest": "^7.2.0",
"eslint": "^9.0.0",
"prettier": "^3.4.0",
"supertest": "^7.2.2",
"tsx": "^4.19.0",
"typescript": "^5.7.0",
"vitest": "^3.0.0"
Expand Down
128 changes: 128 additions & 0 deletions pnpm-lock.yaml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading
Loading