| name | sales-handy |
| description | Handy platform help — open-source, cross-platform speech-to-text desktop app with Whisper and Parakeet STT engines, push-to-talk voice-to-text, GPU acceleration, and Voice Activity Detection (MIT license, 20k+ GitHub stars). Use when setting up Handy on macOS, Windows, or Linux for the first time, choosing between Whisper and Parakeet models for accuracy vs speed, Bluetooth headset causing delayed transcription start, Handy crashing on startup or after macOS update, push-to-talk shortcut not working or conflicting with other apps, comparing Handy to Amical or Wispr Flow or Superwhisper for offline dictation, configuring Voice Activity Detection sensitivity, or running Handy headless with CLI flags for automation. Do NOT use for picking between meeting note-takers generally (use /sales-note-taker) or reviewing a single call for coaching (use /sales-call-review). |
| argument-hint | [describe your Handy question — setup, models, Bluetooth, shortcuts, etc.] |
| license | MIT |
| version | 1.0.0 |
| tags | ["sales","dictation","voice-to-text","open-source","privacy","local-first","platform"] |
| github | https://github.com/cjpais/Handy |
Handy Platform Help
Step 1 — Gather context
If references/learnings.md exists, read it first for accumulated platform knowledge.
-
What do you need help with?
- A) Installing Handy or first-time setup (macOS / Windows / Linux)
- B) Choosing between Whisper and Parakeet STT models
- C) Bluetooth headset latency or audio input issues
- D) Push-to-talk shortcut configuration or conflicts
- E) Voice Activity Detection (VAD) sensitivity tuning
- F) Running Handy headless or via CLI flags
- G) Comparing Handy to other dictation tools
- H) Crashes or startup issues
-
Which platform are you on?
- A) macOS (Intel or Apple Silicon)
- B) Windows (x64)
- C) Linux (x64)
Skip-ahead rule: if the user's prompt already contains enough context, skip to Step 2.
Step 2 — Route or answer directly
| Problem domain | Route to |
|---|
| Comparing Handy to meeting note-takers | /sales-note-taker {user's question} |
| Reviewing a specific call for coaching feedback | /sales-call-review {user's question} |
| Building a coaching program | /sales-coaching {user's question} |
| General tool integration patterns (Zapier, webhooks, iPaaS) | /sales-integration {user's question} |
When routing, provide the exact command.
Step 3 — Handy platform reference
Read references/platform-guide.md for the full platform reference — STT models, installation, CLI flags, VAD configuration, known issues.
Answer the user's question using only the relevant section. Don't dump the full reference.
Step 4 — Actionable guidance
You no longer need the platform guide — focus on the user's specific situation.
First-time setup priority: Install via brew install --cask handy (macOS), winget install cjpais.Handy (Windows), or download from GitHub releases (Linux) → grant microphone permissions → press global shortcut (default: configurable) → speak → release → text pastes into active app.
Model selection: Parakeet V3 for CPU-only machines (fast, auto language detection). Whisper Turbo for GPU machines (best accuracy/speed balance). Whisper Large for maximum accuracy when speed is not critical.
