What is stored
Data lives in the OS configuration directory by default (%APPDATA%\wrolp-terminal on Windows)
and can be pointed anywhere from Settings.
| File or directory | Contents |
|---|---|
window.json | Window, recording and keepalive settings |
connections.json | Connections and workspaces, stored encrypted |
wrolp.db | SQLite database: session index, command sets, snippets |
recordings/ | NDJSON session recordings |
vault.key | AES-256-GCM vault key, bound to the current machine |
data_root.json | Records the chosen data directory; kept at the default location |
Relocating the data directory
Settings can point the data directory at any location. wrolp.db, recordings/,
connections.json and the window configuration migrate together.
- The choice is written to
data_root.jsonat the default location and takes effect on the next start. - If the target is empty, the existing data is copied into it.
- If the target is not empty, it is reused.
- Existing data is never overwritten.
vault.keycan optionally be migrated with the rest, which is what makes the whole directory portable.
Backup considerations
There is no separate backup button; migration moves the same files a backup needs to capture. A consistent copy
should include wrolp.db, recordings/, connections.json,
window.json and, if you want the AI keys to travel, vault.key.
Database maintenance
Settings show the current size of wrolp.db and the space that can be reclaimed, with a
Compact now action that runs VACUUM.
Related chapters
- Chapter 11 — Session recording & export.
- Chapter 10 — AI assistant: the vault key protects the stored API keys.