RelatedWorks

A native macOS literature manager for CS researchers.
Organize papers, annotate with cross-references, and generate
Related Works sections — powered by local or cloud AI.

✦ Project-based workspaces — one project per paper you're writing
✦ PDF import with AI metadata extraction (title, authors, abstract)
✦ DBLP + arXiv search with automatic BibTeX fetching
✦ Semantic IDs and @cross-reference annotations
✦ One-click Related Works generation in LaTeX via AI
✦ Multiple AI backends — Ollama (local) and Google Gemini
✦ Export & import projects as .relatedworks files
✦ Full Terminal UI — keyboard-driven, works over SSH
✦ Live search & filter — search by ID, title, authors, venue, year, abstract, or annotation with match highlighting
✦ Deep link support via relatedworks:// URIs

⬇ Download Latest ⌥ View Source

Requires macOS 13+. Use Ollama locally or a Gemini API key.

💻 Graphical UI

Main interface with paper list, annotations, and cross-references

Paper detail view — annotations with @cross-reference linking and live cross-reference navigation

Drop a PDF — AI extracts title, authors, abstract, and suggests a semantic ID automatically

Generated Related Works section in LaTeX

One-click Related Works generation — LaTeX-ready output synthesized from your annotations

BibTeX export — fetched from DBLP or auto-generated, ready to paste into your .bib file

🖥 Terminal UI

RelatedWorks ships a full interactive TUI — perfect for keyboard-driven workflows, SSH sessions, or when you prefer staying in the terminal. The TUI shares all data with the GUI in real time.

$ ./relatedworks-tui   # bundled in release zip

┌──────────────────────────────────────────────────┐
│ RelatedWorks — Projects                          │
├──────────────────────────────────────────────────┤
│ › [a1b2c3d4]  My Survey Paper  (5 papers)        │
│   [e5f6a7b8]  LLM Efficiency Study  3 papers     │
├──────────────────────────────────────────────────┤
│ ↑↓ navigate  Enter select  q quit                │
└──────────────────────────────────────────────────┘

# Press / to search papers live inside a project

┌──────────────────────────────────────────────────┐
│ My Survey Paper  [/bert_]                        │
├──────────────────────────────────────────────────┤
│ › [@BERT]  BERT: Pre-training of Deep...  (2019) │
│   [@RoBERTa]  RoBERTa: A Robustly Optimized…     │
├──────────────────────────────────────────────────┤
│ type to filter  Esc clear  Enter/↑↓ navigate     │
└──────────────────────────────────────────────────┘

↑ ↓ navigate/scroll Enter select / navigate cross-refs / live search r regenerate (output view) q back Ctrl+D quit