{
  "name": "debug-panel-and-logs",
  "description": "How to use the debug panel, session logging, and terminal diagnostics",
  "tags": [
    "debug",
    "logging",
    "diagnostics",
    "troubleshooting"
  ],
  "category": "system",
  "created": "2026-06-08T16:31:55.508Z",
  "updated": "2026-06-08T19:49:09.059Z",
  "content": "---\nname: debug-panel-and-logs\ndescription: How to use the debug panel, session logging, and terminal diagnostics\ntags: [debug, logging, diagnostics, troubleshooting]\ncategory: system\n---\n## Steps\n1. **Toggle debug panel:**\n   - debug — opens real-time debug panel showing last AI tool call, response time, and context\n   - Debug panel includes Copy, Export, and Write to VFS buttons\n   - Export: saves tool call log as timestamped JSON to downloads\n   - Write to VFS: appends debug data to /debug.log (dedup by turn ID)\n\n2. **Session logging:**\n   - logs [n] [LEVEL] — view last n log entries (optionally filtered by INFO/WARN/ERROR)\n   - logrotate — rotate current.log to dated archive (auto-cleans old logs beyond 10)\n   - Logs stored in /logs/ directory: current.log + dated archives\n   - Health check runs automatically after complex tasks\n\n3. **Diagnostic commands:**\n   - health-check — full audit: VFS size, modules, logs, trash, skills\n   - check — quick system health including module requirement status\n   - mem — real-time memory usage (also in header)\n   - status — network, files, modules, Ollama connectivity\n\n4. **System journals:**\n   - debug.log — appended by debug panel VFS button (dedup by turn ID)\n   - current.log — system activity log with rotation\n   - Auto-save: terminal state auto-saves every 60s\n\n5. **When to use:**\n   - AI is behaving unexpectedly → debug to see tool calls\n   - User reports errors → logs 50 ERROR to see error entries\n   - Memory concerns → mem to check, health-check for full audit"
}