Lineage

Getting started with Lineage

New to Lineage? This page explains what it is, what you need, and what a first week with it looks like. No technical background is assumed. When you want the commands, the Quickstart has them on one page.

What Lineage is

Every family has its history scattered: a grandparent's memories, a shoebox of letters, photographs in three houses, a census entry nobody has looked up. Lineage gathers it into one record that you own, checks it against public records, and keeps every fact tied to where it came from.

From that record it builds:

Everything is plain files (text, spreadsheets, the original scans) in a folder on your computer. The record outlives any app, including this one.

What you need

  1. Something to start from. One recorded conversation with a relative is enough. So is a box of photographs, or a single family Bible.
  2. A Mac or Linux computer.
  3. A Claude subscription and Claude Code. Claude does the reading, transcribing, researching and writing, following Lineage's rules. You talk to it in plain English.
  4. About an hour for the first setup.

Step 1: look around the demo

Before using your own family, open the demo. It shows a finished record for the Calders, an invented family, so you can see where you are heading. Open the live demo in your browser, or run make demo on your own machine (see the Quickstart).

The Home tab shows the story of the day, the relatives, and what needs a person's decision.

Home: the story of the day, the relatives and what needs deciding

Step 2: add what the family has

Everything comes in through Sources. Drop in recordings, photographs, letters, PDFs or links. Lineage reads each one, writes a summary, and tags it with the people, places and dates in it. It never renames or alters your originals.

Sources as a gallery

Click any item to see what was found in it and correct anything that is wrong.

One source opened: its summary, its subjects and where it is used

Step 3: let the record build itself

Ask Claude Code to transcribe the recordings and build the record. The Familypedia fills in with an article for every subject. Each sentence carries a footnote, so you can always see whether a fact came from a recording ("told"), from a document ("what the records show"), or from family lore.

A Familypedia article: infobox, sections and numbered references

Articles are not only about people. Ships, regiments, companies and places get their own.

An article about a company the family worked for

The Genealogy draws the family tree. No line is drawn without evidence behind it.

The genealogy, every link backed by evidence

The Timeline puts every dated event in order, and flags where two sources disagree.

The timeline, coloured by how well each date is known

Step 4: read the stories

From the recordings, Lineage writes stories in the family's own voice, with quotations kept exact and every paragraph cited. Each one can be read as finished book pages, downloaded as a PDF, or listened to as narration.

The Stories tab: read, download or listen

Open a story to read it as pages, with every paragraph's sources beside it.

Reading a story, with each paragraph's sources

Step 5: invite the family

Relatives can add what they have, too: their own recordings, photographs and corrections. Everything they add is reviewed before it counts.

Inviting contributors

Step 6: share it, or print it

When you are ready, Lineage publishes a read-only website of the record, like the demo, and builds a printed book with a table of contents, an index and a list of every source. You decide what is public. Living relatives can be left out, and private passages stay private.

Three rules Lineage always keeps

Where to go next