Okie

Understand the change. Then decide.

Okie is a Mac app for reviewing GitHub pull requests. It reads the PR before you do, writes the brief, groups 142 files into 4 review units, and walks you through them. You approve on GitHub.

Download for MacSee how a review works
Okie / netflix/web
Synced
← Queue
Critical#481 · netflix/web
Add continue-watching row to the TV home
Start review →
jsmith · 3h ago · 142 files · +3,821 −912
ReviewMap
What changed
The continue-watching row now loads from a precomputed feed instead of querying playback history on render. Feed rebuilds run in a background job and failed rebuilds are retried.
Why
Profiles with long histories made the TV home render slow enough to miss the frame budget.
Meaningful changes142 files reduced to 4
1. We move continue-watching to a precomputed feed.
The TV home reads a cached feed instead of querying playback history on render.
4 files
2. We rebuild the feed when playback stops.
A new worker listens for playback-stop events and writes the feed.
3 files
3. We retry a failed feed rebuild.
Three attempts with backoff. The retry wraps the whole rebuild, not only the write.
3 files
4. The row shows a stale badge while a rebuild is pending.
Badge and skeleton state on the TV home row.
2 files
Architecture affected
You open the TV home on a profile.
↓
We read the continue-watching feed for that profile.new
↓
A worker rebuilds the feed when playback stops.new
↓
We store the feed with a TTL.changed
Risk areas
ConcurrencyError handlingData

The Review Brief for PR #481. What changed, why, which parts of the system move, and the four units worth your time.

THE PROBLEM

You open a 2,000-line PR and start at file 1. Generated noise sits next to the one behavioral change. The diff viewer treats them the same. Time to a confident approval is the cost.

How a review works04
INBOX⌘K
#481Add continue-watching row to the TV homecritical · 12 min
#479Refactor profile switcher statehigh · 8 min
#483Migrate playback events to v2 schemamedium · 6 min
#312Retry failed playback heartbeatsroutine · 1 min
1Inbox

PRs waiting on you, sorted by how much human attention they need. File count, risk count, time estimate.

ReviewMap
Architecture affected
You open the TV home on a profile.
↓
You resume a title from the row.new
↓
We read the continue-watching feed for that profile.new
↓
The player starts from the saved position.changed
2Brief

What changed, why, which parts of the system move, and the files you can skip.

Review 1 / 3Routine attention
We add a retry policy for failed playback heartbeats.
REVIEW QUESTIONS
Can a retried heartbeat move the saved position backwards?
playback/heartbeat-retry.ts+42 −6
SkipNeeds changes✓ Looks good
3Guided review

One unit at a time. Why it matters, the questions, the few files that touch it, then a decision. Enter, C, J/K.

REVIEW COMPLETE
Retry failed playback heartbeats
3 review units · 4 min elapsed · 18 files, 5 inspected
✓Retry policy for failed playback heartbeatsLooks good
✓Heartbeats carry a monotonic sequence numberLooks good
✓Tests cover the exhausted-retry pathLooks good
Request changesApprove on GitHub
4Approve on GitHub

Your decisions post back as a real review, with a record of what you inspected and what you skipped.

LOCAL AND PRIVATE

GitHub OAuth on your Mac. The token is encrypted locally and settings live on disk. Okie sits in the menu bar and polls for new review requests.

LOCAL AGENTS, OPTIONAL

Point Okie at Claude or Cursor CLI on your machine. The agent reads the repo and the PR and fills the brief. Okie is the cockpit; the agent is the research assistant.

WHO IT’S FOR
The staff engineer
reviewing an AI-authored PR.
The tech lead
protecting an architecture.
The person
who is “the reviewer” on too many repos.

macOS. Connect GitHub. Pick repos. Review.

Download for Mac

Early builds aren’t notarized yet. If macOS blocks the first launch, open System Settings → Privacy & Security and choose “Open Anyway”.