Walkthroughs

Short, outcome-focused jobs in the workbench (docker compose up, then http://127.0.0.1:8765). They complement the command reference; they do not replace it.

The screenshots are a live ocean/BBNJ collection. Follow the same clicks on any collection chip.

CLI recipes for the same verbs live in Workflows (paperful all, named run configs). How a fill searches: How it works.

Common workflows

Start here. First-time users should follow 1 → 3 in order.

#

Walkthrough

Outcome

1

First fill

On Wanted: preview missing PDFs, grab copies onto out/, attach the ones you trust

2

Grow the library

Search a topic or follow people, review, add metadata parents

3

Tidy a collection

Lint, fix identifiers, review duplicates — before or after a fill

Walkthroughs 1–3 do not need a local model. Index Ask and Briefs do (Ask your library, LLM).

More playbooks

Playbook

Outcome

Research pack

Cited-in-PDF works → parents → PDFs

Author watch

Named people → their new papers

Snowball

Keyword / DOI / ORCID crawl (CLI depth)

Ask your library

Cited answers from PDFs already on disk

Prerequisites

  • Docker Compose, then docker compose up (Docker).

  • Zotero on the host with the local API enabled (Zotero).

  • A real email in config.toml (Unpaywall). doctor on System shows the next step for each amber/red row.