1 files changed, 14 insertions, 0 deletions
diff --git a/skills/debug-panel-and-logs.json b/skills/debug-panel-and-logs.json
new file mode 100644
index 0000000..a895fb5
--- /dev/null
+++ b/skills/debug-panel-and-logs.json
@@ -0,0 +1,14 @@
+{
+  "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-06T02:32:54.007Z",
+  "updated": "2026-06-06T04:17:00.189Z",
+  "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"
+}
+\ No newline at end of file