메뉴
Handless app architecture, project structure, and core patterns. Use when understanding or modifying the app's structure, data flow, module responsibilities, or adding new features that span backend and frontend.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
Use before cutting a release to verify build, version, and smoke test.
Add a new cloud speech-to-text provider to Handless. Use when integrating a new cloud STT API (e.g., Google Cloud STT, Azure Speech, Rev AI). Covers Rust backend, provider registration, settings defaults, dictionary injection, realtime WebSocket support, and i18n across all 17 locales.
CLI flags and remote control parameters for Handless. Use when working with command-line arguments, autostart integration, signal handling, or remote instance control.
Force the onboarding page to display during development, even when permissions are already granted. Use when testing or iterating on the onboarding UI.
Use before cutting a release to verify build, version, and smoke test.
SOC 직업 분류 기준
| name | architecture |
| description | Handless app architecture, project structure, and core patterns. Use when understanding or modifying the app's structure, data flow, module responsibilities, or adding new features that span backend and frontend. |
Tauri 2.x desktop speech-to-text app: Rust backend + React/TypeScript frontend.
Audio (CPAL) -> VAD (Silero) -> STT Provider (local Whisper/Parakeet/Moonshine/SenseVoice or cloud) -> Post-processing (LLM) -> Output (Clipboard/Paste/Overlay)
managers/ (audio, model, transcription, history), initialized at startup via Tauri managed statesrc-tauri/src/)lib.rs - App entry point, Tauri setup, plugin registrationmain.rs - CLI arg parsing, launches run()actions.rs - Transcription pipeline action handlers, streaming sessions, drop guardstranscription_coordinator.rs - Single-threaded event serialization for transcription lifecyclesettings.rs - AppSettings struct, persistence, custom deserializersmanagers/)audio.rs - Recording, VAD integration, system audio mute/unmute, clamshell detectionmodel.rs - Model download/extraction, engine types, state trackingtranscription.rs - STT coordination, provider integrationhistory.rs - SQLite history DB, migrations, audio file storagecommands/)mod.rs - Core commands (cancel, settings, shortcuts, enigo init)audio.rs - Device listing, audio settingsmodels.rs - Model management commandstranscription.rs - Transcription controlhistory.rs - History CRUDaudio_toolkit/)audio/ - CPAL-based recording, device enumerationvad/ - Silero VAD with smoothing wrappertext.rs - Output filtering, custom word replacementstt_provider.rs - Provider abstraction (local vs cloud)cloud_stt/ - Cloud integrations (OpenAI, Soniox realtime via WebSocket)apple_intelligence.rs - macOS ARM64 Apple Intelligence providerpost_process/)client.rs - HTTP client for LLM callsprocess.rs - Post-processing pipelineprompts.rs - Builtin correction/prefix promptsproviders.rs - Provider definitionscommands.rs - Post-process Tauri commandsoverlay.rs - Platform-specific overlay (NSPanel/GTK layer shell/WebviewWindow)shortcut/ - Global shortcuts + HandyKeys libraryinput.rs - Keyboard/mouse simulation via Enigoclipboard.rs - Clipboard save/restore (Wayland support via wl-copy)tray.rs / tray_i18n.rs - System tray with theme detectiondevice_watcher.rs - Audio device hot-plug detectionaudio_feedback.rs - Start/stop recording soundscli.rs - CLI flags (clap derive)signal_handle.rs - Unix signal handlers (SIGUSR1/2)src/)stores/settingsStore.ts - Core settings (Zustand)stores/modelStore.ts - Model state, download progresscomponents/)Sidebar.tsx - Navigation with section-based routingsettings/general/ - Core settings (language, theme, devices)settings/models/ - Model selection, downloadssettings/shortcuts/ - Keyboard shortcut configsettings/post-processing/ - LLM text correctionsettings/history/ - Transcription historysettings/stats/ - Usage statisticssettings/advanced/ - Advanced settingssettings/debug/ - Debug toolssettings/about/ - App infomodel-selector/ - Model selection UIonboarding/ - First-run flowupdate-checker/ - Auto-updateui/ - 25+ base components (Radix UI + Tailwind)overlay/)RecordingOverlay.tsx - Streaming transcription display, position-awarebindings.ts - Auto-generated Tauri command types (specta)lib/utils/ - Formatting, keyboard display, RTL supporthooks/ - useSettings, useModelActions, useOsType, useTheme, usePostProcessStats