How waynetd777/brainstead works
Brainstead is a desktop app for tasks, notes, and an AI-assisted wiki stored as plain Markdown in a user-chosen vault. The main workflow starts in the app UI, uses the Rust-backed vault and domain features, and reads or changes vault files; changes can be reviewed and reverted. Separate capabilities include task queries and GTD reviews, source ingestion and claim checking, assistant chats and tools, and Teams/Outlook capture and sync. The graph uses README statements and the shown source references; unsampled implementation links are omitted or marked unverified.
Main entry points: App.tsx App screens · Ingest.tsx Ingest screens · ingest.rs Source ingestion · api.ts UI API
Components 24
Desktop app
- App screens
src/App.tsx - UI API
src/api.ts - Navigation
src/nav.ts - Settings store
src/store.ts - Platform services
src-tauri/src/platform/mod.rs - App logging
src-tauri/src/applog.rs
Vault and notes
- Vault service
src-tauri/src/vault.rs - Notes
src-tauri/src/notes.rs - File edits
src-tauri/src/edits.rs - Change history
src-tauri/src/changes.rs - Dataview parsing
src/md/dataview/parse.ts
Tasks and GTD
- Task screens
src/Tasks.tsx - Task queries
src/tasksq/query.ts - Weekly reviews
src-tauri/src/reviews.rs
Wiki and assistants
- Ingest screens
src/Ingest.tsx - Source ingestion
src-tauri/core/src/ingest.rs - Wiki knowledge
src-tauri/src/knowledge.rs - Assistant chats
src-tauri/src/ask.rs - Terminal interface
src-tauri/mcp/src/lib.rs - Claim checking
src-tauri/core/src/claims.rs
Capture integrations
- Outlook capture
extensions/outlook-capture/background.js - Teams capture
extensions/teams-capture/extractor.js - Teams Outlook sync
src-tauri/src/sync/run.rs
Other components
- User
Connections 25
- User → App screens: uses
- App screens → UI API: calls
src/App.tsx - App screens → Navigation: navigates
src/App.tsx - App screens → Settings store: reads state
src/App.tsx - Settings store → UI API: saves settings
src/store.ts - UI API → Navigation: uses
src/api.ts - User → Vault service: chooses vault
- Vault service → Notes: serves vault notes
- User → Task screens: manages tasks
- Task screens → Task queries: queries tasks
- User → Weekly reviews: runs weekly review
- User → Ingest screens: starts ingest
src/Ingest.tsx - Ingest screens → Source ingestion: runs ingest
- Source ingestion → Claim checking: checks claims
src-tauri/core/src/ingest.rs - User → Assistant chats: asks assistant
- Terminal interface → Assistant chats: drives app
- User → Outlook capture: captures mail
- User → Teams capture: captures chats
- Teams capture → Ingest screens: supplies sources
- Outlook capture → Ingest screens: supplies sources
- User → Teams Outlook sync: enables sync
- Source ingestion → Change history: lists changes
- Change history → File edits: reverts edits
src-tauri/src/changes.rs - Assistant chats → File edits: makes changes
src-tauri/src/ask.rs - User → Dataview parsing: uses note queries