Quick Start

Get MindWiki running in under 10 minutes. By the end of this guide, you'll have a vault syncing to the cloud with AI agents ready to organize your knowledge.

Prerequisites

Step 1: Download MindWiki

Download the MindWiki app for your platform from the download page. Run the installer and open the app.

Step 2: Create Your Vault

MindWiki works with your existing Obsidian vault or creates a new one. When you first launch:

  • Choose Create New Vault or Use Existing Vault
  • If creating new, MindWiki sets up the standard folder structure:
my-vault/
├── capture/          # Raw inputs land here
├── patterns/         # AI-detected patterns
├── self/             # Personal reflections & values
├── systems/          # Processes & workflows
├── research/         # Deep dives & references
├── projects/         # Active project notes
└── _templates/       # Page templates

Step 3: Connect Cloud Sync

In MindWiki settings, connect your Cloudflare account:

  • Go to Settings → Cloud Sync
  • Click Connect Cloudflare
  • Authorize MindWiki to create an R2 bucket for your vault
  • Sync starts automatically — your vault is now backed up to the edge

Step 4: Enable AI Agents

Turn on the agents that organize your vault:

AgentScheduleWhat it does
ClassifierEvery SundayFiles captures into the right folders
Auto-LinkerEvery SundayAdds wikilinks between related pages
Pattern Detector1st of monthFinds structural patterns across domains

Go to Settings → AI Agents and toggle each one on.

Step 5: Connect Your AI

To give Claude or ChatGPT access to your vault:

  • Go to Settings → MCP Server
  • Copy your MCP server URL and API key
  • Add the server to your AI client's MCP configuration

For Claude Code, add to your MCP settings:

json
{
  "mcpServers": {
    "mindwiki": {
      "url": "https://your-vault.mindwiki.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Step 6: Capture Your First Thought

Try one of these capture methods:

  • In Obsidian: Create a new note in capture/
  • Share sheet: Share a link or text from your phone to MindWiki
  • Email: Forward something to your personal {username}@mindwiki.io address

That's it. Wait for the next agent run (or trigger one manually from Settings) and watch your vault organize itself.

Next Steps