Diagnostics / Self-Fix
Key principle Hamster AI will never apply a fix without your explicit confirmation. It suggests, you decide.

How It Works

When a health check fails or an error is logged, Hamster AI analyses the problem and may offer a fix suggestion in the Diagnostics window or in chat (via /fix). Each suggestion shows:

Safe Fixes (Applied After Approval)

FixWhat it does
Restart internal servicesRestarts the plugin manager or event bus without a full app restart
Retry failed operationRe-attempts the last failed action (e.g. Ollama connection)
Disable broken pluginTurns off a plugin that failed to load or crashed
Recreate missing foldersCreates data/, data/logs/, or config/ if they were deleted
Repair missing configRestores a config file to its default values
Start OllamaAttempts to launch ollama serve as a background process
Pull missing modelRuns ollama pull <model> for the selected model
Clear temporary filesDeletes cached or temp files that may be causing issues

Fixes That Require Extra Confirmation

The following actions require an additional explicit confirmation step because they affect user data or system settings:

These are never applied automatically — even if Hamster AI believes it's the right fix.

Running Self-Fix from Chat

/fix

Shows the current list of available fix suggestions based on recent errors and health check results. Each suggestion can be applied or dismissed from the chat.