great 2026.5.16

Personal media tracking and ranking via active pairwise/k-way comparison.

A reusable engine for personal media tracking and ranking, inspired by gwern.net/resorter. Rather than asking you to assign absolute scores, Great elicits pairwise or k-way comparisons and infers rankings via the Plackett-Luce model.

The work is split across two repositories. This one is the engine: CLI, library, and static-site renderer. A separate data repo holds your items, comparisons, and consumption log as plain text files in git, and deploys a public ranked-list site to GitHub Pages on push.

Install

uv tool install great

Quick Start

Bootstrap a data repo and try the loop locally:

mkdir my-media && cd my-media
great init                          # seeds one list per kind
great want "Severance" --kind tv    # add to the (per-kind) want queue
# Edit items/movies.toml to add some watched items, then:
great rank movies                   # rank what you've watched
great rank tv --want                # rank what you want to watch next
great consumed "Severance"          # promotes the wanted item to the catalog
great build                         # render → dist/

A working sample lives in examples/sample-data/. great init (default --with-pages) drops a GitHub Actions workflow that builds the site and deploys to Pages on every push.

CLI

great init [PATH] [--list NAME:KIND]... [--with-pages]

Bootstrap a data repo (drops a Pages-deploy workflow by default).

great lists

Show configured lists.

great rank <list> / great rank <kind> --want

Run a Textual ranking session — over a favorite-list, or (with --want) the want queue for <kind>.

great show <list> / great show <kind> --want

Print the inferred ranking, favorites or want.

great log <item> [--status ...] [--notes ...] [--at DATE]

Append a diary entry. Consuming a wanted item promotes it to the catalog.

great consumed <item> [--at DATE]

Alias for log --status consumed.

great want <title> --kind KIND [--year YEAR] [--id ID]

Add a free-form title to the kind’s want queue (one queue per kind).

great unwant <item> [--kind KIND]

Remove from the kind’s want queue.

great build [--out dist/]

Render the static site.

Development

uv sync
uvx nox            # runs all default sessions
uvx nox -s tests   # just tests
uvx nox -s style   # ruff check + format
uvx nox -s typing  # ty