keyboard-first paper triage

Triage daily arXiv papers without leaving the terminal.

Load your local history/ archive or search arXiv live, then move from scan to summary, citations, tags, and export without breaking flow.

Path 1

Review archived digests with persistent state, date navigation, bookmarks, and watch lists.

Path 2

Search arXiv directly by category, title, author, or abstract when you want the newest results now.

Layer on later

Enable Semantic Scholar, HuggingFace, and LLM workflows only when you want richer context.

Install once

$ uv tool install arxiv-subscription-viewer

Alternative: pip install arxiv-subscription-viewer

Start with both workflows Open guide hub View on GitHub
arxiv-viewer
/ cat:cs.AI unread
Ctrl+p commands
Ctrl+s summary
arXiv Subscription Viewer interface showing terminal paper triage

local-first

Keep notes, tags, bookmarks, and exports under your control.

optional enrichment

Citations, trending signals, summaries, and relevance only when you enable them.

See it in action

A full-featured TUI for navigating the world of academic papers

arxiv-viewer
Demo of arXiv Subscription Viewer TUI

Workflow pillars

The app is organized around the real paper-review loop: scan, enrich, organize, and export.

Scan quickly

Filter with fuzzy search, structured query tokens, bookmarks, watch lists, history navigation, and keyboard-first movement through loaded papers.

Enrich on demand

Pull in Semantic Scholar citations, HuggingFace daily-paper signals, and LLM summaries, chat, relevance scoring, or auto-tagging only when they help.

Organize the reading queue

Track read state, stars, tags, notes, marks, bookmarks, and collections so your next pass through the literature starts from your own metadata.

Export without lock-in

Open PDFs, copy metadata, export BibTeX/Markdown/RIS/CSV, download files in batches, and snapshot your annotations for backup or migration.

Quick Start

Install once, then choose the workflow that matches how you already follow the literature.

$ uv tool install arxiv-subscription-viewer
# or: pip install arxiv-subscription-viewer
Path 1

history/ workflow

Run arxiv-viewer from the directory that contains your history/ folder. The app restores session state, keeps date navigation available, and works well when you review daily digests in order.

$ mkdir -p ~/research/arxiv/history
$ cd ~/research/arxiv
# Save digest as history/2026-02-13.txt
$ arxiv-viewer

Tip: automate this by writing each digest to history/YYYY-MM-DD.txt.

Path 2

No-email / API workflow

Skip local digest files entirely and start from live arXiv search results when you want to scan the latest matching papers immediately.

$ arxiv-viewer search --category cs.AI
# or: arxiv-viewer search --query "diffusion transformer" --field title

Use this path when you want the latest matching papers without maintaining a local archive first.

Useful launch commands

arxiv-viewer --color never --ascii

arxiv-viewer dates

arxiv-viewer doctor

Default destinations

General exports: ~/arxiv-exports/

PDF downloads: ~/arxiv-pdfs/

Metadata portability: explicit timestamped JSON snapshots

Guide Hub

Use this page as the published entrypoint, the GitHub README for installation and shortcuts, and the docs index for markdown-first browsing inside the repository.

Markdown guide links below open on GitHub so they stay readable from the published site without adding a separate docs platform.

Start here

Main README

Install commands, quick launch examples, feature highlights, and the full keyboard shortcut table.

Repository map

Docs index

Browse the markdown docs set directly when you want a GitHub-friendly table of contents and reading order.

Workflow guide

History mode

Set up history/, ingest daily digests, and use date navigation effectively.

Workflow guide

Search and filters

Learn structured queries, API search flows, bookmarkable filters, and faster scanning patterns.

Reference

Configuration reference

Go straight to the config schema when you need export paths, presets, toggles, or enrichment settings.

Support

Troubleshooting

Use this when arxiv-viewer doctor surfaces issues or setup does not behave as expected.

More feature guides

LLM setup Semantic Scholar HuggingFace Export and PDF

First 2 Minutes

A short keyboard-first walkthrough once the app is open.

?

Open the help overlay and scan the main shortcuts without leaving the paper list.

/

Open search, type something like cat:cs.AI, and narrow the visible papers immediately.

Space

Select the highlighted paper so browser, export, copy, and download actions can operate on it.

o

Open the current or selected paper in your browser.

E

Open the export menu for BibTeX, Markdown, RIS, CSV, and clipboard workflows. File exports go to ~/arxiv-exports/ by default.

A

Jump into an arXiv API search without restarting the app.

Ctrl+p

Open the command palette for metadata, collections, and advanced workflows.

[ ]

Move to the previous or next digest date when you are in history/ mode.

Advanced Workflows

Start with local browsing or live search, then layer these in when a paper deserves deeper context.

Semantic Scholar

Prerequisites: optional s2_api_key for higher rate limits, plus Ctrl+e at runtime or "s2_enabled": true in config.

First use: press Ctrl+e to enable enrichment, then e on a paper to fetch citations, TLDR, and fields of study. Use R and G after that.

HuggingFace Trending

Prerequisites: toggle with Ctrl+h or enable on startup with "hf_enabled": true.

First use: press Ctrl+h, let the app cross-match the loaded papers, then inspect the HuggingFace section in the detail pane for upvotes, GitHub links, keywords, and summaries.

AI Summary / Chat / Relevance / Auto-Tag

Prerequisites: configure llm_preset or llm_command; relevance scoring also uses research_interests.

First use: try Ctrl+s for summaries, C for chat, L for relevance scoring, and Ctrl+g for auto-tagging. Custom LLM commands prompt for trust on first execution.