Vault & Full-Text Search
Everything XWX Backup saves lands in the vault — plain Markdown files on your disk, backed by an instant search index. This page explains how the vault is organized and how to find anything you’ve archived.
Where the vault lives
By default the vault sits in your user directory (~/.xwx-backup/vault). Change it in Settings → Vault if you prefer another drive or a synced folder.
- One Markdown file per conversation, named after the conversation title
- YAML frontmatter on every file: title, platform, model, created/updated timestamps, tags, word count and source URL
- The file layout is deliberately boring: any editor, script or PKM tool can read it
Use Re-scan after editing files externally — it rebuilds the search database from the files on disk.
Full-text search
The search bar queries the full text of every message in your vault — not just titles — powered by an SQLite FTS index that returns results in milliseconds.
- Search matches message content across all platforms at once
- Results show title, platform, date and matched snippet
- Click a result to read the conversation in a clean reader view with syntax-highlighted code
Filters, tags & stars
Combine search with filters to narrow the archive:
- Platform — ChatGPT, Claude, Gemini, …
- Account — for multi-account platforms
- Date range — by conversation update time
- Tag — edit tags freely on any conversation
- Starred — flag important conversations and filter to them
Tags and stars are written back into the Markdown frontmatter, so they survive outside the app too.
Maintenance: re-scan, clear, zip
- Re-scan vault — re-reads all files and rebuilds the search index (run after external edits or restores)
- Package as ZIP — bundle the current filtered selection into a ZIP archive for offsite storage or sharing
- Clear archive — deletes vault contents and the index. Destructive; your settings are kept