Menú
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.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
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.