swarmvault add

swarmvault add is the opinionated capture layer on top of generic URL ingest.

Usage

swarmvault add <url-or-arxiv-id-or-doi> [--author <name>] [--contributor <name>]

Supported Inputs

• arXiv abstract URLs such as https://arxiv.org/abs/2401.12345
• bare arXiv ids such as 2401.12345
• DOI URLs such as https://doi.org/10.5555/example
• bare DOI strings such as 10.5555/example
• X/Twitter post URLs
• generic article URLs
• unsupported URLs fall back to the normal swarmvault ingest <url> path

What It Does

1. Normalizes supported URLs into markdown captures with stable frontmatter
2. Writes the capture into the normal immutable source/manifests flow
3. Keeps the result compatible with compile, query, search, and graph pages

Normalized captures record research-friendly frontmatter when available:

• source_type
• source_url
• canonical_url
• title
• authors
• published_at
• updated_at
• doi
• arxiv_id
• tags

Use ingest when you want the generic low-level path. Use add when you want a better capture shape for common research links.