CortexCraft
A local second brain for an Obsidian vault, readable by people and by agents.
- Design and development
- Personal open-source project (MIT licence).
- Released
The problem
A growing Obsidian vault becomes hard to navigate, and AI assistants have no clean way into it. Existing solutions often go through the cloud.
Constraints
- Everything stays local: no account, no remote sync.
- The vault remains an ordinary Markdown folder, readable without the app.
- Agents must be able to read and write without breaking the user’s notes.
The solution
A Tauri 2 app (Rust core, TypeScript interface) that scans the vault, follows its revisions live and renders it as a 3D cortex, with [[wikilink]] links as synapses. The same binary provides a command-line MCP server (cortexcraft mcp). Notes written by the app live in a reserved folder, CORTEX/.
What was built
- Vault scan and live revision tracking.
- 3D cortex with several layouts and groupings.
- Daily capture, Markdown creation and editing with version backups.
- Command palette (
⌘K). - Imports: conversations, Apple Notes, Apple Health, Markdown exports.
- Analyses as tables and waves.
- Command-line MCP server.
Results
Version 0.1.0 is released, with macOS, Windows and Linux builds produced by CI. Phase 1 is verified by npm run build, the cargo test suite and an interface check on a demo vault.
What it shows
A complete cross-platform desktop application, from the 3D interface to distribution, designed from the start to be driven by a person as well as by an agent.