ResearchVault 🦞

Autonomous state manager for agentic research.

Core Features

• The Vault: Local SQLite persistence for artifacts, findings, and links.
• Divergent Reasoning: Create branches and hypotheses to explore parallel research paths.
• Synthesis Engine: Automated link-discovery using local embeddings.
• Active Verification: Self-correcting agents via verification_missions.
• MCP Server: Native support for cross-agent collaboration.
• Watchdog Mode: Continuous background monitoring of URLs and queries.

Workflows

1. Project Initialization

uv run python scripts/vault.py init --id "metal-v1" --name "Suomi Metal" --objective "Rising underground bands"

2. Multi-Source Ingestion

uv run python scripts/vault.py scuttle "https://reddit.com/r/metal" --id "metal-v1"

3. Synthesis & Verification

# Link related findings
uv run python scripts/vault.py synthesize --id "metal-v1"

# Plan verification for low-confidence data
uv run python scripts/vault.py verify plan --id "metal-v1"

4. MCP Server

uv run python scripts/vault.py mcp --transport stdio

Environment

Requires Python 3.13 and uv.