Docs / Architecture

Architecture

Three layers: a native shell, a canvas library, and a frontend on top of both.

Shell

Tauri v2, Rust plus WebView2 on Windows or WKWebView on macOS, chosen over a plain browser app for real filesystem access, OS-keychain key storage, background wake-word listening, and an HTTP client that is not CORS-bound, which removes any need for a relay proxy in front of local servers.

Canvas

React Flow (@xyflow/react, MIT). Every block is a plain React component, and board state is literally { nodes, edges } JSON, which doubles as the file format on disk and as the assistant's structured view of the board.

Frontend

React 19, Vite, and TypeScript.

Source layout

src/ agent/ the assistant loop, its tools, and paper search canvas/ command layer, board store, React Flow host, block components providers/ LLM and speech-to-text adapters, and the provider registry screens/ workspace browser, canvas, settings, document reader workspace/ workspace file I/O and autosave src-tauri/src/ workspace.rs workspace folders, atomic board writes, transcripts, search documents.rs document import and text extraction (PDF, Word, Markdown) keys.rs BYOK keys in the OS keychain speech.rs OS text-to-speech

Going deeper

DESIGN.md, the full design and the build log behind it, written by hand.
DeepWiki, a generated tour of the codebase, machine-written from the source.