Documentation

Maintenance & automation

Use the built-in maintenance tools to tidy storage, monitor performance, and automate recurring tasks.

Core maintenance tools

These utilities are available from the ribbon, command palette, or settings tabs.

Document processing writes structured logs to SystemSculpt/devlogs/document-processing.log for easy audits.
The Janitor modal scans vault directories, lists empty items, and batches cleanup actions before anything is removed.
Directory health checks run on startup and can rebuild folder structure when something goes missing.

Monitoring & diagnostics

Performance instrumentation runs continuously once the plugin loads.

  • Freeze monitors track UI hangs and raise notices when the main thread stalls.
  • Startup tracing highlights slow steps so you can spot problem plugins or large vault operations.
  • Version checks compare your install to the latest release and surface update banners.
Diagnostics tips
Pair the built-in monitors with the error collector to capture stack traces when something misbehaves.

Automation playbook

  • Use the command palette entry Rebuild Embeddings (Current Model) after major edits, and run Convert to Markdown from the file menu when you need a fresh extract.
  • Approved MCP tools follow the same chat approval flow, so remote automations log their actions and respect your permissions.
  • Turn on freeze monitoring or copy diagnostic logs from Advanced settings when a workflow feels slow and you need extra detail.
Headless modeIf you run SystemSculpt in headless environments, invoke the same services through MCP servers so the plugin’s guardrails stay in place.