Menu
Use to orient in the oats codebase or plan cross-cutting features โ the cloud-vs-offline backend split, the speech-to-text pipeline, window topology, and where specs live.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when changing oats backend โ Rust commands in src-tauri, the invoke contract, capabilities/permissions, Tauri plugins, multi-window, or running the cargo test suite. Includes the macOS build/test workarounds.
Use when changing oats code that touches auth/OAuth, session tokens, the capabilities allowlist, a Tauri invoke command, file paths, URL/deep-link opening, the sidecar, network calls, or the offline-mode privacy guarantee. Encodes this app's real attack surface and a pre-PR review checklist.
Use when reproducing or diagnosing runtime behavior in the running oats desktop app โ driving and inspecting its windows via the oats-desktop MCP server (execute JS, read DOM, invoke backend commands). Pairs with systematic-debugging.
Use when building or changing oats frontend UI โ Vue 3 components, views, composables, routing, Tailwind, or the TipTap notes editor. Encodes this repo's frontend conventions.
| name | oats-architecture |
| description | Use to orient in the oats codebase or plan cross-cutting features โ the cloud-vs-offline backend split, the speech-to-text pipeline, window topology, and where specs live. |
oats is a macOS menu-bar meeting recorder/notetaker: hit record, get a transcript and notes. Tauri v2 (Rust) + Vue 3 (TypeScript). Apple Silicon only.
The defining design choice is a backend abstraction (src/composables/useBackend.ts
on the frontend; STT/storage modules on the Rust side):
When designing a feature, ask which backend(s) it touches and keep the abstraction intact โ don't hardcode cloud-only or local-only paths into shared code.
Local transcription uses ariso-stt, a Swift/MLX speech engine shipped as a sidecar
binary (src-tauri/binaries/ariso-stt-aarch64-apple-darwin, plus mlx-swift_Cmlx.bundle).
Rust side: audio_capture.rs (Core Audio process taps for system audio + mic),
transcribe.rs, model_manager.rs (model download/management), storage.rs (recordings
~/.ariso).All windows load one Vue bundle and render a hash route (src/main.ts):
main (/) โ headless BootstrapView; runs sync/startup logic, intentionally blank.settings (/settings) โ the settings window (pre-created hidden at startup).library (/library) โ titled "Meetings"; the main user-facing window
(created on demand, destroyed on close).waveform, update, meeting-picker, onboarding, and the borderless prompt
windows meeting-prompt, silence-prompt, meeting-end-prompt.The tray (tray.rs, tray_meeting.rs) and recorder pill (recorder_pill.rs) are the
menu-bar surface.
src/ (views/, composables/, tauri.ts) โ see oats-vue.src-tauri/src/ โ see oats-tauri.docs/superpowers/specs/ (YYYY-MM-DD-<topic>-design.md). Read
recent specs before a related feature; write a new one (via the brainstorming workflow)
before non-trivial work.For runtime inspection of any window, use oats-debugging.