Docs/Maintenance

Maintenance

Minerva keeps search, tables, related-note suggestions, and everything else up to date on its own as you write — you don't run any of this on a schedule. The handful of actions below are here for the rare moment when something looks stale or stuck and you want to give it a nudge. You'll almost never need them.

The actions

Rebuild All Indexes
File menu
Refreshes everything Minerva keeps behind the scenes — search, tables, and the connections between notes — from your notes as they are right now. Use it if something looks out of date and you want to be sure nothing was missed.
Rebuild Semantic Index
File menu
Rebuilds the "related notes" and meaning-based search from scratch. Minerva normally keeps this current for you; reach for this only if related-note suggestions seem clearly wrong. It runs in the background and you can keep working while it finishes.
Interrupt Cell
File menu
Stops a code cell that's taking too long, while keeping the results you've already built up. Handy when a cell is caught in a loop or is slower than you expected. If nothing is running, Minerva says so rather than looking like it did something.
Restart Python Kernel
File menu
Clears everything your code cells have worked out and starts them fresh. Reach for this when results look confused or you want a clean slate. See Code & compute cells for how they work.

Knowing where it's up to

None of these leave you guessing. Rebuilding all indexes and restarting the Python kernel both put a message on screen while they work — the rebuild counts the notes as it goes — and the app waits until they're done, because a half-rebuilt thoughtbase isn't much use to search or query against. Rebuilding the semantic index is different: it stays out of the way in the status bar and you can keep writing while it runs.

Each one tells you when it's finished, with a brief note of what it did. If something goes wrong — a file it can't read, a disk that's full — you'll be told that too, rather than being left to wonder whether it worked.

The File menu open, showing Rebuild All Indexes, Rebuild Semantic Index, Interrupt Cell, and Restart Python Kernel grouped together.
The File menu's maintenance actions
You don't need a routine

There's no checkup to run and no "repair" button to press on a schedule. Minerva keeps itself in order as you work, so treat this menu as an occasional nudge for the rare case when something looks off — not something to reach for out of habit.