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.
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.
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.
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.
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.
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.
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.
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.
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.
Links between documents
Links from one document or section to another, with a preview on hover.
Link a document or section to another, and the link shows a preview on hover.
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.