Logs — Hamster AI

Log Location

Logs are written to:

data/logs/hamster_ai.log

The log file rotates automatically to prevent it growing too large. Old rotated files are kept as hamster_ai.log.1, hamster_ai.log.2, etc.

Log Levels

Level	When it appears
DEBUG	Detailed internal events — only useful when tracking down a specific bug
INFO	Normal operational events — startup, mode changes, plugin load
WARNING	Something unexpected happened but the app recovered
ERROR	Something failed — usually actionable
CRITICAL	A severe failure that may prevent the app from functioning

Viewing Logs

Three ways to view logs:

In chat: /logs (recent entries) or /errors (errors only)
Diagnostics window: right-click tray → Diagnostics
Directly: open data/logs/hamster_ai.log in any text editor

Privacy in Logs

Sensitive data is never written to logs:

Work Mode window titles are not logged
Private Mode activity is not logged
Chat message content is not logged (only event metadata)
Memory content is not logged

Clearing Logs

Clear the log file from the Diagnostics window, or with:

/clear-logs

Note Clearing logs is permanent. If you're reporting a bug, export the diagnostic bundle first from the Diagnostics window.

Log Format

2026-05-12 14:32:01 INFO  [core.startup] Hamster AI started (model: llama3.2:3b)
2026-05-12 14:32:02 INFO  [plugins] Loaded: session_awareness, insights, scheduled_reminders
2026-05-12 14:32:02 WARNING [plugins] voice_output: pyttsx3 not installed — plugin disabled
2026-05-12 14:33:10 ERROR [ollama_client] Connection refused — is Ollama running?