Documentation
Topics
Automatic clustering of your notes and clips on local embeddings. ⌘2.
Topics groups your Stream by meaning, not by hand. Local embeddings cluster notes, clips, and screenshots into themes; each theme gets a card and an automatically chosen label.
How it works
- Every element is embedded on-device with an MLX model (Qwen3-Embedding by default). Nothing is sent anywhere – see Semantic search for how the embeddings themselves work.
- Clustering is K-Means over those embeddings, run locally, capped at 11 topics plus an “Unsorted” bucket for anything not yet embedded – enough to orient, not enough to become folders.
- Each topic’s label is picked automatically from the most common significant word across its items’ titles – no AI call, no manual naming.
- Topics rebuild each time you open the mode, or on demand with Regenerate (⇧ ⌘ R) – it’s not a live view, so adding a note won’t reshuffle cards until you ask it to.
Using Topics
- ⌘ 2 opens the card grid. Arrow keys move between cards in all four directions; ⌃ H/J/K/L (vim) and ⌃ B/N/P/F (Emacs) apply first/next/prev/last instead – left/right only, no up/down. ⏎ opens a topic.
- Inside a topic, the list behaves like the Stream: same up/down navigation (including the vim/emacs keys – see Hotkeys), same Action Menu, same detail view, same Force Touch peek and drag-and-drop out of the window.
- Search inside Topics finds semantically similar elements – useful for “more like this” moments.