readwise-triage

Swipe through your Readwise Reader inbox like Tinder.

Why? · How it works · Installation · Usage · License

Why?

Readwise Reader is great at collecting articles. The problem is the inbox grows faster than you can read it. You open the app, see 200+ unread items, feel overwhelmed, and close it again.

What you actually need is a quick way to triage: keep the stuff worth reading, archive the rest, and move on. That's hard to do in Reader's own UI because every article feels like a commitment.

readwise-triage turns your inbox into a card stack. Left to archive, right to keep. You can burn through dozens of articles in a few minutes.

How it works

• Syncs your Readwise Reader library (inbox, later, shortlist) to a local SQLite database
• Shows one article at a time as a swipeable card
• Left arrow archives it in Reader, right arrow moves it to your shortlist
• Down arrow generates an AI summary (via OpenRouter) so you can decide without opening the article
• Tracks what you've read and lets you undo the last swipe
• Dark and light themes, keyboard-driven

Installation

Requires Bun.

git clone https://github.com/sasha-computer/readwise-triage.git
cd readwise-triage
bun install

Create a .env file with your API keys:

cp .env.example .env

You'll need:

• READWISE_TOKEN -- get one from readwise.io/access_token
• OPENROUTER_API_KEY -- get one from openrouter.ai (only needed for AI summaries)

Usage

Sync your library and start the UI in one command:

bun run start

Open localhost:3141 and start swiping.

You can also run sync and dev separately if you prefer:

bun run sync   # pull documents from Readwise Reader
bun run dev    # start the triage UI

Keyboard shortcuts

Key	Action
←	Archive (dismiss)
→	Keep (shortlist)
↓	Show AI summary
u	Undo last swipe
Esc	Close summary overlay

Running tests

bun test

License

MIT