‘embark-live’ a live-updating variant of ‘embark-collect’

Finally, there is also an ‘embark-live’ variant of the ‘embark-collect’ command which automatically updates the collection after each change in the source buffer. Users of a completion UI that automatically updates and displays the candidate list (such as Vertico, Icomplete, Fido-mode, or MCT) will probably not want to use ‘embark-live’ from the minibuffer as they will then have two live updating displays of the completion candidates!

A more likely use of ‘embark-live’ is to be called from a regular buffer to display a sort of live updating "table of contents" for the buffer. This depends on having appropriate candidate collectors configured in ‘embark-candidate-collectors’. There are not many in Embark’s default configuration, but you can try this experiment: open a dired buffer in a directory that has very many files, mark a few, and run ‘embark-live’. You’ll get an Embark Collect buffer containing only the marked files, which updates as you mark or unmark files in dired. To make ‘embark-live’ genuinely useful other candidate collectors are required. The ‘embark-consult’ package (documented near the end of this manual) contains a few: one for imenu items and one for outline headings as used by ‘outline-minor-mode’. Those collectors really do give ‘embark-live’ a table-of-contents feel.