swarmvault explore

Run a save-first multi-step exploration loop against the compiled vault.

Usage

swarmvault explore <question> [--steps <n>] [--format markdown|report|slides|chart|image]

Arguments

  • <question> — The root research question

Options

  • --steps <n> — Maximum number of exploration steps to run. Defaults to 3
  • --format markdown|report|slides|chart|image — Output format used for saved step pages and the hub page

Examples

swarmvault explore "What should I investigate next?"
swarmvault explore "How does this topic break down?" --steps 5
swarmvault explore "Turn this research trail into a report" --format report
swarmvault explore "Show this trail as charts" --format chart

How It Works

  1. Runs a normal query against the current vault
  2. Saves that answer into wiki/outputs/
  3. Asks the model for a structured set of follow-up questions
  4. Chooses the next follow-up deterministically
  5. Repeats until the step limit is reached
  6. Runs any configured orchestration roles to add follow-up questions or review notes
  7. Writes a hub page linking the root question, step pages, and generated follow-up questions
  8. For chart and image, writes local output assets under wiki/outputs/assets/<slug>/
  9. Refreshes the graph, search index, and related page links after each saved run

The result is a durable exploration trail instead of a one-off chat session.