swarmvault inbox import

Import supported files from the configured inbox directory.

Usage

swarmvault inbox import [dir]

Arguments

  • [dir] - Optional inbox directory override. If omitted, SwarmVault uses workspace.inboxDir from config.

What It Does

  1. Recursively scans the inbox directory
  2. Imports supported files such as markdown, text, reStructuredText, HTML, PDFs, Word documents (.docx family), Rich Text (.rtf), OpenDocument files (.odt, .odp, .ods), EPUB books, CSV/TSV datasets, Excel workbooks (.xlsx family including legacy .xls), PowerPoint decks (.pptx family), Jupyter notebooks, BibTeX, Org-mode, AsciiDoc, transcripts, Slack exports, email, calendar files, structured config/data files, developer manifests, and images (including modern formats like .heic, .avif, .jxl)
  3. Detects browser-clipper style markdown and HTML bundles with local sidecar assets
  4. Copies referenced assets into raw/assets/
  5. Rewrites markdown and HTML image paths to point at canonical stored assets
  6. Deduplicates repeated content by content hash

Important Behavior

  • Inbox import is non-destructive in the current release
  • Referenced sidecar assets are tracked as manifest attachments
  • Original inbox files are left untouched

Typical Workflow

swarmvault inbox import
swarmvault compile