Everything MindWiki actually ships.
MindWiki is an AI-connected markdown vault. A native macOS app for editing, a web app for capture and AI connections, and a single MCP/API endpoint that any modern AI client can plug into. Below is the real list — nothing here is planned vocabulary.
Two surfaces, one vault
Native macOS app. Editor, command palette, slash commands, a knowledge graph, properties inspector, agents workspace, drag-and-drop attachments, and offline-first sync. Files live on your Mac as plain markdown.
Web vault. Sign in at mindwiki.io, edit pages, run quick captures from any browser, manage AI connections, API keys, and billing. Same vault, same files, the web is the lighter capture and review surface.
Edits propagate both ways within seconds. Optimistic concurrency with explicit conflict files instead of silent overwrites — see the sync model docs for the exact algorithm.
The vault format
- Plain markdown files. No proprietary database layer between you and your text.
- YAML frontmatter for per-page properties like
title,area,tags,created,type. [[wikilinks]]that resolve by title or path. Bidirectional — every page automatically tracks what links into it.- Attachments stored under
_assets/with content-hash naming, so images and PDFs don't move around under your feet.
Editor + capture
The macOS editor uses live-preview formatting (headings, bold, italic, callouts, code blocks, dividers, wikilink pills, checkbox toggles) plus inline interactive tables and a slash command menu. The same interactive tables and slash menu now ship in the web editor too.
Capture lands in one place. A dedicated capture/ folder is the only built-in directory. Inputs that route there:
- The web app's Quick Capture box.
- The macOS app's
Cmd+Ndialog. - A personal
{username}@mindwiki.ioemail address — emails land as pages incapture/. - The
mindwiki_captureMCP tool, when an AI decides a fragment of conversation is worth keeping.
Wikilinks, backlinks, and the knowledge graph
Every [[link]]is recorded as an edge in your vault graph. The macOS app ships a real graph view: nodes are pages, edges are wikilinks, and you can pan/zoom to find what you've been thinking about across domains. Backlinks for any page are a single click.
Search and views
Hybrid keyword + vector search across the whole vault, from both apps and from MCP. Web supports a files panel, search panel, and favorites; macOS adds table/cards/calendar/kanban views built from page properties.
MCP and HTTP API for AI clients
MindWiki exposes a single MCP endpoint at https://api.mindwiki.io/mcp. Claude (Pro), ChatGPT (Plus), Claude Desktop, Claude Code, Codex, and other MCP-aware clients can connect via OAuth and start reading and writing the same vault you do. Twenty MCP tools today: read/search/ask/graph/similar/list/lint on the read side, write/capture/index-rebuild on the write side, plus the agent layer (proposals, sessions, activity, operating guide, context packs).
For tools that don't speak MCP, the same surface is available as a REST API with Bearer-token authentication. Scope it as read, write, or both when you mint a key in your account settings. See the API reference.
Pro automation
Pro adds four scheduled vault automations. Three of them (Auto-Linker, Weekly Classifier, Pattern Detection) are proposal-first — they suggest changes you review before anything lands. Monthly Summary is the exception: it writes one additive summary page directly each month.
- Auto-Linker(daily): scans recently changed pages and proposes wikilinks where another page's title appears unlinked.
- Weekly Classifier (Sunday): reviews recent captures and proposes moves to the right area or tag suggestions.
- Pattern Detection (Sunday): surfaces cross-domain patterns, near-duplicates, and structural drift across the vault.
- Monthly Summary (1st of month): the only automation that writes a page directly — a month-end summary at
outputs/monthly-summary/YYYY-MM.md.
All four run on MindWiki-managed AI (you don't need a separate API key for them). Toggle each one independently in Account → Settings.
Sync, conflicts, and exports
- Sync between macOS and web via the changes log + monotonic sequence cursor. New devices catch up by replaying changes from cursor zero.
- Conflict files instead of silent overwrites. Local + remote edits to the same page both survive as
page.conflict-*.mdfiles you can merge. - Export the whole vault as a zip from Account → Settings → Export. You always have a copy.
What MindWiki deliberately doesn't do
- No surprise AI edits. Three of the four Pro automations (Auto-Linker, Weekly Classifier, Pattern Detection) write proposals you review before anything lands. Monthly Summary writes one additive page per month at a fixed path. Direct AI client edits only happen through MCP/API credentials and scopes you authorize.
- No shared/team vaults. MindWiki is a single-user knowledge base today.
- No one-click importer from Notion or Obsidian. Migration is markdown-first plus the capture and API endpoints. Obsidian vaults are markdown already, so point MindWiki at the same folder; Notion exports as markdown.
- No proprietary lockup.The vault is a folder. Export, walk away, come back — it's yours.