What problem does it solve?
archive-crawler helps you explore large personal file archives and surface the high-value writing, ideas, and relationship material worth ingesting into your wiki—without accidentally scanning or ingesting sensitive data.
Core Features & Use Cases
- Safety-gated archive scanning: Refuses to run unless
gbrain.yml explicitly allow-lists archive-crawler.scan_paths for the permitted scan roots.
- Interactive triage with a persistent manifest: Builds an inventory and a priority queue, then records per-item review status and the user’s exact reactions in
projects/<archive-slug>/STATUS.md.
- Gold-filtered ingestion into brain pages: Reads candidate files, applies a “gold” relevance filter, and when you approve, files content into the appropriate brain directories based on your filing rules.
- Multi-source archive support: Works across local mounts and multiple archive formats/targets (e.g., Dropbox/B2/Gmail takeouts/mbox/pst), while skipping noise like configs, system files, and binary junk.
Quick Start
Add an explicit allow-list under archive-crawler.scan_paths in your gbrain.yml, then tell the agent: "crawl my archive and surface the writing worth keeping".