https://github.com/cowprotocol/cow-triage-web

🤠 A compact review workload board for CoW Protocol PRs. See who is currently requested for review, which team queues are aging, and which PRs still need a reviewer.
https://github.com/cowprotocol/cow-triage-web

Last synced: 8 days ago
JSON representation

🤠 A compact review workload board for CoW Protocol PRs. See who is currently requested for review, which team queues are aging, and which PRs still need a reviewer.

• Host: GitHub
• URL: https://github.com/cowprotocol/cow-triage-web
• Owner: cowprotocol
• Created: 2026-05-13T10:32:22.000Z (21 days ago)
• Default Branch: main
• Last Pushed: 2026-05-22T14:41:02.000Z (12 days ago)
• Last Synced: 2026-05-22T19:51:10.297Z (12 days ago)
• Language: JavaScript
• Homepage: https://cow-triage-web.vercel.app
• Size: 126 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 🐮 CoW Triage

[![Live app](https://img.shields.io/badge/live-cow--triage--web.vercel.app-225ad6?style=flat-square)](https://cow-triage-web.vercel.app/)

[![GitHub API](https://img.shields.io/badge/data-GitHub%20REST%20API-162033?style=flat-square)](https://docs.github.com/en/rest)

[![Static app](https://img.shields.io/badge/app-static%20HTML%2FCSS%2FJS-12805c?style=flat-square)](./index.html)

> A compact review workload board for CoW Protocol PRs. See who is currently requested for review, which team queues are aging, and which PRs still need a reviewer.

**Open it:** https://cow-triage-web.vercel.app/



## ✨ What It Does

- 🧑‍💻 Groups open PRs by requested reviewer, requested GitHub team, or no active review request.

- 🚦 Highlights PR age: green `<7d`, yellow `7-14d`, red `>14d`.

- 🔥 Surfaces aging reviews, oldest PRs per lane, and PRs with no active review request.

- 🧭 Defaults to `cowprotocol/cowswap`, with searchable repo switching.

- 🔎 Filters by age, reviewer/team, activity, review need, sort mode, and free-text PR search.

- ✅ Shows review signals like approvals, changes requested, and review/comment activity.

- 🙋 Shows a token-aware **Needs my attention** view for requested PRs you did not author and have not reviewed or commented on yet.

- 👥 Shows requested GitHub team lanes first when team data is available.

- 🔗 Keeps filters in the URL so views are easy to share.

- 💤 Hides draft PRs by default, including from counts and metrics.

- 🔁 Auto-refreshes on a configurable interval.

## 🎯 Why It Exists

CoW Triage shows **current requested-review load**, not historical reviewer output. It helps answer:

- Who currently has the most requested reviews?

- Which queue has the oldest waiting PR?

- Which PRs have no active review request?

- Which team review requests are aging?

## 🕹️ How To Use

1. Pick a repo from the searchable repo selector.

2. Use the age, reviewer/team, activity, review need, sort, and search filters to narrow the board.

3. Click **Aging reviews** to jump to PRs open for more than 14 days.

4. Click **No active review request** to focus PRs with no current requested reviewer/team.

5. Use **Clear filters** to reset target/activity/review need/age/search while keeping the selected repo.

6. Open **Settings** to change card gradients, draft visibility, auto-refresh, or GitHub token.

## 🔐 GitHub Token Safety

A token is optional for public PRs, but useful to avoid rate limits and required to see org team review requests and private repos reliably.

Without a token, CoW Triage only sees public GitHub data. With a token, it can only show private repositories your GitHub account is already allowed to access.

Use a **fine-grained token** for `cowprotocol` with only:

- `Metadata: read`

- `Pull requests: read`

Avoid classic tokens. Do **not** grant write, admin, workflow, code, or organization-management permissions. The token is stored only in this browser session and is sent only to GitHub.

## 🔗 Shareable Views

Filters are reflected in the URL:

```text

?repo=cowswap&target=team:frontend&status=ready&review=needs-review&age=red&sort=priority&drafts=hide

```

Supported params:

- `repo=cowswap`

- `target=all | user: | team: | unassigned`

- `status=all | ready | stale | draft`

- `review=all | needs-review | needs-my-attention | enough-approvals | has-review-activity`

- `age=all | green | yellow | red | draft`

- `sort=priority | oldest | recently-updated | newest`

- `drafts=hide | show`

GitHub tokens are never written to the URL.

## 🧱 Local Dev

No build step required:

```text

open index.html

```

The app is plain HTML, CSS, and JavaScript using the GitHub REST API.