Open PRs Bookmarks ToucanTechno מאת

<strong>Your review queue, on your bookmarks bar.</strong>
This add-on maintains a folder on the bookmarks toolbar containing one bookmark per GitHub pull request that is assigned to you or waiting on your review, plus the ones of yours that were merged recently. Click the folder, see what's on your plate, open any of them in a click, without keeping a GitHub tab open or refreshing github.com/pulls.

<strong>How it works</strong>
<ul>
<li>Paste a GitHub personal access token into the add-on's preferences (Settings → Developer settings → Tokens (classic), with the <code>repo</code> scope).</li>
<li>Choose which pull requests belong in the folder: review requested, assigned to you, reviewed by you, opened by you, recently merged and assigned to you, or any combination.</li>
<li>The folder refreshes when Firefox starts, on a timer you set (10 minutes by default), and whenever you click the toolbar button.</li>
<li>The toolbar button doubles as a status light: it shows how many pull requests are in the folder, or a red badge if a sync failed.</li>
</ul>

<strong>Setting up the token</strong>
The add-on talks to GitHub as you, using a token you create yourself. It takes about a minute:
<ol>
<li>Go to <a href="https://github.com/settings/tokens">github.com/settings/tokens</a> (GitHub → your avatar → Settings → Developer settings → Personal access tokens).</li>
<li>Choose <b>Tokens (classic)</b> → <b>Generate new token (classic)</b>.</li>
<li>Give it a name and an expiry; 90 days or less is sensible.</li>
<li>Tick the top-level <code>repo</code> checkbox and nothing else. Its five sub-boxes tick themselves; leave them. <code>repo</code> is the only scope that can see private repositories.</li>
<li>Generate, then copy the token. GitHub shows it exactly once.</li>
<li>Open the add-on's preferences, paste it in, and press <b>Save & sync now</b>.</li>
</ol>

<strong>Organisation repositories</strong>
You don't need to own a repository for its pull requests to appear. The token reaches whatever your account can already read, including org-owned private repos. Two organisation settings can still get in the way:
<ul>
<li><b>SAML SSO</b>: click <em>Configure SSO</em> next to your new token and authorise the organisation.</li>
<li><b>Token policy</b>: an organisation can block classic tokens entirely, in which case an owner has to permit them.</li>
</ul>
In either case the sync still succeeds, it just quietly returns fewer pull requests, because GitHub's search omits what the token can't see.

Fine-grained tokens work too, with <em>Pull requests: Read</em> and <em>Metadata: Read</em>, but you must set <em>Resource owner</em> to the organisation and wait for an owner to approve the request.

<strong>No bookmark churn</strong>
The folder is reconciled in place rather than rebuilt: pull requests that no longer match drop out, new ones appear, renamed ones get updated titles, and everything else keeps its existing bookmark, so syncing every few minutes doesn't churn your bookmarks or your Firefox Sync history. Sub-folders you put inside it are left alone.

<strong>Privacy</strong>
There is no server and no account. Your token is stored in your Firefox profile and is sent only to api.github.com, as you. Nothing is collected, logged, or transmitted anywhere else. The source is four unminified files with no build step.