Most problems with Docket are one of four things. If none of these is yours, write to docket@izitech.co.uk and include the diagnostics described at the foot of this page.
This is the most common one, and it is almost never a bug in Docket.
An organisation can restrict which third-party applications reach its repositories. Until an owner approves Docket, GitHub returns no results and no error for those repositories — so the app cannot tell "you have nothing open" apart from "you cannot see what you have". It says so on the empty screen rather than guessing.
Open Settings → Account. It lists the organisations that have approved Docket, and links to the GitHub page where every organisation you belong to appears with a Grant or Request button. If you are not an owner, that button raises a request for one.
A newly registered application starts from nothing here: approval granted to an earlier one does not carry over.
WidgetKit decides when a widget may refresh, and the budget is roughly 40 to 70 timeline requests a day. In practice that means every 20 to 30 minutes rather than on a fixed clock, and Docket cannot override it.
Press Refresh in the app when you want it now. The widget reads what the app writes, so refreshing the app updates the widget too.
If the app itself shows a banner about GitHub's hourly limit, refreshing will not help until the limit resets — the allowance is spent, and the banner says so rather than letting it look like a bug.
Right-click the desktop, choose Edit Widgets, search for Docket, and add a size. If it does not appear, quit and reopen the app once: that re-registers the extension with macOS.
Docket uses GitHub's device flow. Press Sign in with GitHub and the app copies a code to your clipboard and opens github.com; paste the code, approve, and the app signs itself in. It polls, so you do not have to come back to it.
The step that leaves the app is deliberate — it is GitHub's own page, and Docket never sees your password.
Settings has three ways to narrow it. Hide drafts and hide bot pull requests apply everywhere. Tracked repositories gives every repository two switches: one for the main screen and one for the widgets, so you can follow thirty repositories in the app and count only a handful on the desktop.
The sidebar also narrows the list to particular owners for as long as you need it; that filter is not remembered between launches, on purpose.
In Settings → Support, press Copy diagnostics. It puts a short description of what the app is doing on your clipboard: versions, how old the snapshot is, the counts, the last failure, and what is left of GitHub's hourly allowance.
It contains no repository names, no pull request titles, no username and no token, so you can paste it into an email or a public issue without checking it first.
Send it to docket@izitech.co.uk with a sentence about what you expected to see.
macOS 14 Sonoma or later, and a GitHub account. Docket has no server and no account of its own — see the privacy policy.