know.

Cookbook

The pantry

Every part of know.sh the recipes use, as it ships today, with the recipes that use it.

Shelf

A named place for documents on one subject, with a line on what it is for and room for notes.

Everything in a library sits on a shelf: a name, a line on what it is for, and notes of its own. Documents list in natural order, and each shelf has its own slice of the index.

Used in 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 16, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 34, 36, 38, 39, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60

Document

A titled document with an overview and numbered sections: the chapter of your book.

The chapter of your book: a title, an overview written like a chapter’s opening, and numbered sections. Each document keeps a stable number, No. 12, and one row of actions: Star, Focus, Share, Move and Edit.

Used in 1, 2, 4, 5, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 53, 54, 55, 56, 57, 58, 59, 60

Section

A numbered page inside a document, with a title, a type, an importance and its sources.

A full page of its own, numbered in order, with a title, a body, its sources and one of ten types, from Evidence to Decision. Mark the ones that matter as Key.

Used in 11, 12, 13, 14, 15, 17, 19, 23, 24, 27, 28, 33, 35, 36, 40, 41, 42, 43, 45, 46, 47, 48, 51, 60

The editor

Where you fix up what your assistant built: headings, lists, tables and code, sections reordered, types and Key set.

Your assistant does the heavy lifting; the editor is where the work becomes yours. Write straight into the page, type / for an element, and drag sections into order. It saves a second after you stop typing, and Revisions keep every earlier version.

Used in 4, 5, 6, 29, 37, 47, 48, 57

Elements

Timelines, tables, charts, diagrams, flashcards, slide shows and small working widgets inside a section, drawn by know.sh from what your assistant writes.

53 kinds of rich block inside a section: timelines, tables, charts, diagrams, flashcards, slide shows and working widgets that run in a sealed frame. Your assistant writes them and know.sh draws them in the book’s own ink, light or dark. Turn them on in Account → Elements; with them off, each reads as its words.

Used in 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60

The A–Z index

A back-of-book index of the names and terms that recur in your library, built as you write.

A back-of-book index built as you write: the names, places and terms that recur across your sections, each with the numbers where they appear. Highlighted sections are set in bold.

Used in 1, 3, 11, 38, 39, 43, 46, 48, 49

Quiz

Five to ten questions your assistant writes from a document, each citing the sections it came from.

Ask your assistant for a quiz on a document: five to ten questions, each citing the sections it came from. Take it on the web or the iOS app, and it comes back under Revisit when it is due.

Used in 6, 10, 11, 12, 13, 14, 15, 16, 18, 25, 30, 37, 38, 46

Highlights

Mark a passage as you read; the section’s number turns bold in the index.

Select a passage and Highlight it. The highlight stays attached as the text around it changes, and its section’s number turns bold in the index.

Used in 56, 58

Margin notes

Notes in the margin beside the passage they are about, with flat replies.

Notes in the margin beside the passage they are about, with replies one level deep. They are yours and your assistant’s; readers of a public link never see them.

Used in 22, 44

Proposed notes

Notes your assistant suggests, set apart with a dashed rule until you Accept or Dismiss them.

When your assistant spots something you did not ask about, it leaves a proposed note with Accept and Dismiss. Nothing in your text changes until you say so.

Used in 2, 6, 8, 9, 12, 21, 52, 55

Revisions

Every change to a document or section, marked as yours or an assistant’s, with Restore.

Every change to a document or section, marked as yours or an assistant’s, with Restore. It is what makes it safe to let an assistant loose.

Used in 8, 17, 20, 27, 33, 34, 35, 36, 40, 41, 42, 51

Public link

A read-only link to one document, with an optional password, an expiry, and sections left out.

A read-only link to one document, with an optional password and expiry, and any section left out. Readers see the text, never your notes or highlights.

Used in 1, 2, 3, 4, 5, 7, 14, 17, 18, 19, 21, 22, 23, 24, 25, 26, 28, 29, 30, 32, 33, 37, 39, 40, 42, 43, 44, 49, 50, 52, 53, 55, 57, 59

Look up

Search every word in your library from the keyboard with ⌘K or /.

Look up (⌘K, or /) searches every word as you type: index terms, documents, sections, highlights and shelves.

Used in 7, 9, 15, 26, 52, 54, 58

Star and Focus

Star the documents you keep coming back to; put one in Focus for a week.

Star the documents you keep coming back to. Put one in Focus for a week, and Revisit tells you when the week is up.

Used in 10

Contents

The library as a table of contents: by shelf, by month filed, recent, starred or shared.

The library laid out like the front of a book: by shelf, by month filed, or recent, starred and shared.

Used in 20

Campaigns

Turn research into a plan: operations with statuses, dependencies and a graph.

Turn research into a plan: operations with statuses and dependencies, laid out as a graph. An assistant with the planning permissions, such as Claude Code with the plugin, can lay one out for you.

Used in 32, 56

Your AI assistant

Bring the AI you already use: Claude, ChatGPT or a local model reads and writes your library through the know.sh MCP server.

Bring the AI you already use. Claude, ChatGPT or a local model connects through the know.sh MCP server and can search, read, write and reorganise your library, with every change kept in Revisions. You sign in once; there is no key to copy. The support page has setup for each.

Used in 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60

Scheduled runs

Your assistant can run on a schedule, gathering the week’s news or checking your sources, so the library stays current.

Claude and ChatGPT can run a prompt on a schedule: this week’s injury news, the papers published on your topic. When the result arrives, reply file this in know.sh and your assistant adds it, with its sources.

Used in 31, 53

Listen

A document read aloud by Kokoro, a voice made on your own device, each word highlighted as it is spoken.

Turn it on in Account → Listening, on iPhone or the web. know.sh reads a whole document aloud, the title, the overview and then each section, in one of nine English voices by Kokoro, made on your own device: nothing you read is sent anywhere to be spoken. Kokoro downloads once, about 87 MB on iPhone. Set the speed from 0.8× to 2×, stop after each section, and on iPhone keep listening with the screen locked, skipping sections from the lock screen or your headphones. An element is named as it comes, by its kind and title.

Used in 45

The iOS app

The same library on iPhone and iPad: read, highlight, note and take quizzes. Now in TestFlight beta.

The same library on iPhone and iPad: read, highlight, note, take quizzes and see elements drawn. In beta on TestFlight today.

Used in 41, 44, 45, 50, 54, 59