# Logs

Everything is written under `%APPDATA%\ArchivstDesktop\logs\` and readable without the GUI:

- `archivst logs --headers` — run-level summaries (start, state, folder, affected files, direction).
- `archivst logs --errors --day <yyyy-MM-dd>` — error entries for a day (defaults to today).
- `logs\console\Console-yyyy-MM-dd.log` — JSON lines, one object per event with `From`, `FileRelativePath`, `DateWritten`, `Completed`, `State`, `Message`, `IsError`, `Details`. Filter on `IsError` to build an error report.
- `logs\h\` — one JSON summary per run (state, affected files, direction, completed flag).
- `logs\<folder-or-All>-<U|D>-<time>.log` — free-text detail per upload (`U`) or restore (`D`) run.

[Back to Agentic Usage](/agentic)