OSA Midnight Oil is a local-first desktop workspace built around a master-locked encrypted vault. It combines planning, note-taking, reference capture, identity organization, wallet storage, research tooling, and a cinematic ROS-style shell into one self-contained environment.
The project is designed to feel like a personal operations desk rather than a cloud app. Workspace data stays local, can be locked behind a passphrase, and is intended to remain useful offline.
Overview: high-level workspace status, counts, trust summary, and quick captureVault Notes: markdown-first notes with structured templates and previewLibrary: local document catalog and reader workflowResearch Vault: structured research intelligence records and study comparisonProfile Organizer: identities, VoIP lines, phone book, PGP bundles, and operator recordsROS Comms: local/native secure messaging workflowNostr Lounge: lightweight read-first social sidecarF*Society: native-only LAN room for discovery, chat, handoff notes, and direct file sendsFlow Studio: wireframe flow and system mappingWallet Vault: wallet records and sensitive material inside the locked workspaceControl Room: backup, recovery, trust posture, export/import, and destructive controlsMidnight Console: local read-only console into the workspace state
- Workspace data is intended to be encrypted at rest.
- Decrypted workspace state only lives in memory during an unlocked session.
- The shell supports manual lock, idle auto-lock, backup export/import, and nuke/reset flows.
- Native desktop builds move more trust boundaries into Rust/Tauri instead of browser-managed storage.
- Local-first behavior is the default. Cloud sync is not required for core use.
The Vite app can run in the browser for rapid UI development and beta compatibility.
npm install
npm run devThe primary desktop path lives under src-tauri and uses Tauri 2.
npm run desktop:devTo build desktop artifacts:
npm run desktop:buildIf cargo tauri is not installed yet:
cargo install tauri-clinpm run dev
npm run build
npm run lint
npm run previewAdditional project utilities:
npm run release:checksumsnpm run site:beta:serve
npm run buildattempts the optional WASM step first. If thewasm32-unknown-unknowntarget orwasm-packis not available, that step is skipped and the Vite build still completes.- Tauri/Rust build artifacts can consume several gigabytes. If local disk is tight, clearing
src-tauri/targetandrust-core/targetis the fastest safe cleanup.
For GitHub upstream, generated artifacts and local machine clutter should stay untracked:
dist/src-tauri/target/rust-core/target/.DS_Store- local
.env*files
The repository should primarily contain source, assets that are intentionally part of the product, release metadata, and documentation.
OSA Midnight Oil is evolving toward a native local-first desktop workspace with:
- stronger Rust-owned trust boundaries
- beta release packaging for macOS, Windows, and Linux
- support/recovery tooling
- structured research and operator workflows
- optional sidecar features like Nostr Lounge and F*Society without turning the core product into a cloud-first platform

