Architecture

A local web app and local backend over a user-owned Markdown vault.

Next.js frontendLocal browser UI for Today, tasks, capture, focus, reviews, settings, and search.

FastAPI backendValidates requests, owns Markdown IO, scheduler/runtime services, and optional AI calls.

Markdown vaultDurable source of truth for user-owned entities under _WorkOS.

SQLite runtimeReminders, task events, indexes, cache, diagnostics, registry, routines, and analytics.

Optional AIOllama/local AI or configured providers. Useful, but never required for normal operation.

Preview-first AI boundary

Capture, task shaping, review generation, ADK/agent output, and import proposals are suggestions. Saving or applying them is a separate explicit action.

Explicit write policy

The control vault configured by WORKOS_VAULT_PATH is the writable Wooolfmesh area. Registered reference or archive vaults are read-only by default. Indexing writes runtime cache rows, not source note edits.

No silent mutation of personal knowledge

Wooolfmesh should not mutate, delete, reformat, migrate, or overwrite real user vault data without explicit user approval.