# Topic Map

> Index passages from your books, notes and Bases, find the topics they share and answer questions with cited cards. Uses Model Hub for models.

## Start

- [Topic Map](https://insurgently.com/docs/topic-map/index.md): Index passages from your books, notes and Bases, find the topics they share and answer questions with cited cards.
- [Getting started](https://insurgently.com/docs/topic-map/getting-started.md): Install Topic Map, make a collection from a folder of notes, index it and search it.

## How to

- [Make a collection](https://insurgently.com/docs/topic-map/collections.md): Tell Topic Map which books, notes or Base rows to read, and through which lens.
- [The Topic Map panel](https://insurgently.com/docs/topic-map/panel.md): See one collection at a time: what it holds, its topics and what has run on it, with its actions in the header.
- [Index a collection](https://insurgently.com/docs/topic-map/index-a-collection.md): Read every passage through the lens into cards, with the cost shown first and a limit you set.
- [Search a collection](https://insurgently.com/docs/topic-map/search.md): Ask a question, read the cards that match, open the passage behind each, and see where books disagree.
- [Repeated terms](https://insurgently.com/docs/topic-map/repeated-terms.md): See a term once when several passages or books use it, see one idea under different names together, and say when two of them are not the same.
- [Find topics](https://insurgently.com/docs/topic-map/find-topics.md): Group a collection's cards into named topics, written as notes you can see in Graph view.
- [The topic map](https://insurgently.com/docs/topic-map/map.md): See a collection's cards as a map of dots, grouped by topic or linked by similarity, its topics as a field of words, and the whole library as one map of books.
- [Draft a write-up](https://insurgently.com/docs/topic-map/draft-a-write-up.md): Answer a question from a collection's cards, in a note where every quote has been checked against its passage.
- [Your collections in Claude](https://insurgently.com/docs/topic-map/use-with-claude.md): Search your collections, follow a card to other books and read its passage from Claude Code, Claude Desktop or Codex, through Model Hub.
- [Choose or make a lens](https://insurgently.com/docs/topic-map/lenses.md): A lens decides what is pulled out of each passage. Use a built-in one, or make your own from it.
- [Survey a collection](https://insurgently.com/docs/topic-map/survey.md): Let Topic Map propose what a collection is about and the fields you can filter its books by.
- [Catalogs](https://insurgently.com/docs/topic-map/catalogs.md): Turn one facet of an indexed collection into a catalog of families and types, with every source's version of each.
- [Undo a run](https://insurgently.com/docs/topic-map/undo-a-run.md): Take back an index run, a survey, a topics run or a draft.

## Reference

- [Settings](https://insurgently.com/docs/topic-map/settings.md): Every setting, in the order the settings pages show them.
- [How big a collection can be](https://insurgently.com/docs/topic-map/limits.md): What gets slow as a collection grows, what Topic Map tells you before it does, and what to do about it.
- [Troubleshooting](https://insurgently.com/docs/topic-map/troubleshooting.md): The messages you may see, and how to fix each one.
- [Privacy and costs](https://insurgently.com/docs/topic-map/privacy-and-costs.md): What is sent where, what costs money and where your files are kept.

## Changes and plans

- [Changelog](https://insurgently.com/docs/topic-map/changelog.json): every version's changes, as JSON
- [Roadmap](https://insurgently.com/docs/topic-map/roadmap.json): what's coming, as Soon and Later, as JSON
- [Everything in one file](https://insurgently.com/docs/topic-map/llms-full.txt)