Skip to main content

arc collections

arc collections has authoring tools for blocklet.yaml's collections: declarations — today, scanning content/ to generate the fragment for you.

arc collections is a small authoring-tool group for the collections: declarations in a blocklet's blocklet.yaml — the block that tells the runtime which content/ subtrees are indexable collections, and what faces (web, sitemap, llms) they expose. Right now it has one subcommand.

bash
arc collections <subcommand> [options]

Global flags (see Overview): --json, --view, --instance / -i (which local ARC instance; omit for default), and --home (instance root; to pick which instance, use --instance).

arc collections scan

Scan a site's content/ directory and emit a collections: YAML fragment you can paste into blocklet.yaml, instead of hand-writing the declaration.

Usage

bash
arc collections scan [dir] [options]
  • [dir] (optional, default .): site root — the directory that contains content/

Example (run from a site root with a content/ tree; two of the emitted collections shown, the rest follow the same shape)

bash
$ arc collections scan .
# Paste into blocklet.yaml. mcp is intentionally omitted — opt-in only (epic #3657 W2).
collections:
  articles:
    type: local:articles
    indexable:
      - "content/articles/**/content.md"
    faces:
      web: true
      sitemap: true
      llms: [index, full]
  docs:
    type: local:docs
    indexable:
      - "content/docs/**/content.md"
    faces:
      web: true
      sitemap: true
      llms: [index, full]
  ...

Paste the emitted fragment into the target blocklet.yaml's collections: key; arc collections scan only prints it, it does not write the file for you.