← Work
CortexCraft icon, an elephant

Open source · Desktop app · AI

CortexCraft

A local second brain for an Obsidian vault, readable by people and by agents.

Role
Design and development
Context
Personal open-source project (MIT licence).
Status
Released
Technologies
  • Tauri 2
  • Rust
  • TypeScript
  • MCP

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.