swarmvault chat

Ask the compiled wiki in a chat session that stays on disk.

Usage

swarmvault chat [question...] [--resume [id]] [--list] [--delete <id>] [--save-output] [--gap-fill] [--max-history-turns <n>] [--format markdown|report|slides|chart|image]

Arguments

  • [question...] - The question to ask. Omit it in a TTY to open the interactive chat loop.

Options

  • --resume [id] - Resume a saved session by id or prefix. When no id is supplied, resumes the most recent session.
  • --list - List saved chat sessions.
  • --delete <id> - Delete a saved session by id or prefix.
  • --save-output - Also persist each answer as a normal wiki/outputs/ query page.
  • --gap-fill - Pull external web-search evidence when the local wiki has gaps and a query web-search provider is configured.
  • --max-history-turns <n> - Number of previous turns to include as conversational context. Defaults to 6.
  • --format markdown|report|slides|chart|image - Answer format for generated turns. Defaults to markdown.

Examples

swarmvault chat "What should the next agent know?"
swarmvault chat --resume <session-id> "What changed since then?"
swarmvault chat --list
swarmvault chat --delete <session-id>
swarmvault chat "Turn this into a review brief" --format report --save-output

What It Writes

Each chat turn searches the compiled vault, includes recent session turns as context, and writes:

  • Structured session state under state/chat-sessions/
  • A markdown transcript under wiki/outputs/chat-sessions/
  • Optional normal query output pages under wiki/outputs/ when --save-output is set

Interactive mode supports /help, /sessions, /status, /clear, and /exit.

Use chat when the important artifact is a reusable conversation. Use `query` when a single saved answer is enough, and `context build` when the next agent needs a bounded evidence pack.