swarmvault init

Initialize a new SwarmVault workspace in the current directory.

Usage

swarmvault init

What It Creates

swarmvault init creates:

• inbox/
• raw/sources/
• raw/assets/
• wiki/
• state/manifests/
• state/extracts/
• state/analyses/
• agent/

It also writes a default swarmvault.config.json if one does not already exist.

swarmvault init also creates a default swarmvault.schema.md. That file is the vault-specific instruction layer used by compile and query.

Default Configuration

The generated config uses the heuristic provider so the workspace can run without API keys:

{
  "workspace": {
    "rawDir": "raw",
    "wikiDir": "wiki",
    "stateDir": "state",
    "agentDir": "agent",
    "inboxDir": "inbox"
  },
  "providers": {
    "local": {
      "type": "heuristic",
      "model": "heuristic-v1",
      "capabilities": ["chat", "structured", "vision", "local"]
    }
  },
  "tasks": {
    "compileProvider": "local",
    "queryProvider": "local",
    "lintProvider": "local",
    "visionProvider": "local"
  },
  "viewer": { "port": 4123 },
  "agents": ["codex", "claude", "cursor"]
}