https://github.com/xvvcs/wdym
Wdym is a lightweight macOS app that instantly turns your messy speech-to-text into sharp, AI-ready prompts with a single shortcut. Works with any app - Claude Code, Cursor, OpenCode. You name it.
https://github.com/xvvcs/wdym
ai-tool open-source prompt-engineering prompt-optimization prompt-tuning
Last synced: 3 months ago
JSON representation
Wdym is a lightweight macOS app that instantly turns your messy speech-to-text into sharp, AI-ready prompts with a single shortcut. Works with any app - Claude Code, Cursor, OpenCode. You name it.
- Host: GitHub
- URL: https://github.com/xvvcs/wdym
- Owner: xvvcs
- License: mit
- Created: 2026-03-04T14:41:04.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2026-03-04T19:48:51.000Z (3 months ago)
- Last Synced: 2026-03-04T21:49:44.048Z (3 months ago)
- Topics: ai-tool, open-source, prompt-engineering, prompt-optimization, prompt-tuning
- Language: Swift
- Homepage:
- Size: 281 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
wdym
What do you mean? — Turn rough dictation and messy text into sharp, AI-ready prompts in an instant
[](https://github.com/xvvcs/wdym/releases)
[](https://swift.org)
[](LICENSE)
[](https://github.com/xvvcs/wdym/releases)
---
## What is wdym?
**wdym** is a lightweight macOS menu bar app for people who think faster than they type or dictate.
Press a global shortcut from **any app**, and wdym instantly captures whatever is in your focused text field, cleans it up, and replaces it with a clear, structured prompt — ready for your AI coding assistant, chat tool, or search bar.
No window switching. No copy-paste loops. Just better prompts, instantly.
---
## Screenshots / Demo
> 📸 _Screenshots and a short demo video will be added here once the first public release is available._
>
>
>
> | Menu Bar | Options Panel | Fast prompt styles switches |
> |----------|---------------|-----------------------------|
> | 
| 
| 
|
---
## Highlights
| Feature | Details |
|---------|---------|
| 🖥️ **Menu bar first** | Lives quietly in your menu bar — no Dock icon, no windows in the way |
| ⌨️ **Global shortcut** | Trigger from any app with a fully customisable key combination |
| ✏️ **Smart cleanup** | Removes filler words, fixes punctuation, and structures your intent |
| 🤖 **AI refinement** | Optional Groq integration for fast, high-quality LLM polish |
| 🎨 **Prompt styles** | General, Coding, Writing, Search, Research, Best Practices |
| 🔁 **Style switch HUD** | Cycle prompt styles from a dedicated shortcut with an on-screen visual picker |
| 📋 **Flexible output** | Replace in-field, copy to clipboard, or both — your choice |
| 🐱 **Terminal-aware** | First-class Kitty/OpenCode support via remote control integration |
| 🔒 **Privacy first** | No history, no analytics — keys in Keychain, prefs in UserDefaults |
---
## Installation
### Download (recommended)
**Latest release:** [**can be checked here**](https://github.com/xvvcs/wdym/releases/latest)
1. Grab the latest from the [**Releases page**](https://github.com/xvvcs/wdym/releases):
- `wdym_installer.dmg` — drag-and-drop installer
- `wdym_installer.zip` — manual fallback
2. Move `wdym.app` to `/Applications`.
3. In the dialog that appears, click Open again.
If macOS still blocks it:
1. Open System Settings → Privacy & Security.
2. Scroll down to “`wdym.app` was blocked from use…” and click Open Anyway.
> **Note:** Free releases are unsigned. macOS may block first launch.
>
> - Right-click `wdym.app` → **Open**, or
> - **System Settings → Privacy & Security → Open Anyway**
>
> Terminal fallback:
> ```bash
> cp -R "/Volumes/wdym/wdym.app" /Applications/
> xattr -dr com.apple.quarantine /Applications/wdym.app
> open /Applications/wdym.app
> ```
### Build from source
Requirements: Xcode 16+, macOS 14+
```bash
git clone https://github.com/xvvcs/wdym.git
cd wdym
open PromptRefactorApp/PromptRefactorApp.xcodeproj
```
Build and run the `PromptRefactorApp` scheme on your local Mac.
---
## Quick Start
1. **Launch** `wdym` — a menu bar icon appears.
2. Open **Options** and grant **Accessibility** permission when prompted.
3. Choose your **output mode**, **prompt style**, and **shortcut**.
4. Place your cursor in any text field (or select text) in any app.
5. Press your shortcut — wdym refines the text and applies the output.
---
## Configuration
All settings live in the **Options** panel in the menu bar.
| Setting | Options |
|---------|---------|
| **Output mode** | Replace + Copy · Replace only · Copy only |
| **Prompt style** | General · Coding · Writing · Search · Research · Best Practices |
| **Style switch shortcut** | Dedicated global shortcut for cycling prompt styles with a transient HUD |
| **Shortcut** | Choose a preset or record your own key combination |
| **AI refinement** | Enable Groq and enter your API key for LLM-powered polish |
| **Groq model** | Speed-first default (`llama-3.1-8b-instant`), configurable |
| **Auto-select** | Automatically select all text in focused field before capture |
API keys are stored securely in **macOS Keychain**. All other preferences are stored in **UserDefaults** and never leave your machine.
---
## Kitty / OpenCode Integration
For deterministic text capture inside Kitty terminal (e.g. with OpenCode), enable Remote Control:
1. Add to your Kitty config (`~/.config/kitty/kitty.conf`):
```text
allow_remote_control socket-only
listen_on unix:/tmp/prompt-refactor-kitty
```
2. Restart Kitty.
3. In wdym **Options**, set the Kitty socket address to match (e.g. `unix:/tmp/prompt-refactor-kitty`).
4. Use **Run Kitty Check** in Options to verify the connection.
wdym will now read the focused prompt field directly via Kitty RC and write back via paste — no clipboard interference.
---
## Privacy
wdym is designed to stay out of your way and out of your data.
- ❌ No prompt history stored
- ❌ No analytics or telemetry
- ✅ Prompt text handled in memory, discarded after processing
- ✅ Local-only processing when Groq is disabled
- ✅ When Groq is enabled, only the current prompt text is sent over HTTPS
- ✅ API keys stored in macOS Keychain; preferences stored in UserDefaults
---
## Contributing
Contributions are welcome! Here's how to get started:
```bash
# Run core package tests
swift test
# Run app tests
xcodebuild \
-project "PromptRefactorApp/PromptRefactorApp.xcodeproj" \
-scheme "PromptRefactorApp" \
-destination "platform=macOS" \
-only-testing:PromptRefactorAppTests \
test
```
The release workflow is [`.github/workflows/release-and-publish.yml`](.github/workflows/release-and-publish.yml).
---
## License
[MIT](LICENSE) © 2026 Prompt Refactor contributors