Log Viewer & Settings
Live server logs, and the feature-flag switches that control a couple of opt-in features.
Log Viewer
Enable ⚙ Settings → General → Show logs to add a Logs button to the topbar. Click it to open a live-streaming view of the server's log output.
- History — the server keeps a configurable in-memory ring buffer (default 500 lines, adjustable in Settings) that is replayed instantly when the modal opens. No disk I/O.
- Live stream — new log lines arrive via Server-Sent Events (
/api/logs/stream) and are appended as they happen. - Auto-scroll — the view stays pinned to the bottom as lines arrive. Scroll up to read earlier output; auto-scroll resumes automatically when you scroll back to the bottom.
- Close disconnects the SSE stream. Re-opening reconnects and replays the current buffer.
Errors are highlighted in red, warnings in amber.
Buffer size
The Log buffer size setting (under Show logs in Settings) controls how many lines are kept in memory. Changes apply immediately — if you lower the size, the oldest lines are trimmed right away. The value is persisted in config/logs.json.
Settings
Click ⚙ in the topbar to open the Settings modal.
| Section | Setting | Description |
|---|---|---|
| General | Show logs | Adds a Logs button to the topbar. |
| General | Buffer size | Number of log lines kept in memory (10–10000, default 500). Only visible when Show logs is enabled. |
| Experimental | Git sync | Adds a Git button to the topbar. See Git Sync. |
Feature flags are stored in localStorage — they are per-device and not synced.