Desktop Copilot Overview
Whis-AI is a smart desktop overlay assistant designed for live meetings and interviews. It stays "Always on Top" of your windows, capturing system audio to provide real-time assistance.
Installation Guide
⚠️ Important Security Note
Because this app is a private internal tool, it is not "Signed" by Apple or Microsoft. You will see a security warning when opening it for the first time. Follow the steps below to bypass it.
Installing on macOS (.dmg)
When you double-click the app, you may see a popup saying: "Whis-AI cannot be opened because the developer cannot be verified" or "App is damaged".
- Open your Downloads folder in Finder.
- Right-click (or Control+Click) on the
Whis-AIapp icon. - Select Open from the menu.
- A new popup will appear asking if you are sure. Click Open.
Alternative: Go to System Settings > Privacy & Security. Scroll down to the "Security" section and click "Open Anyway" next to Whis-AI.
Installing on Windows (.exe)
When you run the installer, you may see a blue window saying: "Windows protected your PC" (Microsoft Defender SmartScreen).
- Click the underline text that says More info.
- A new button will appear at the bottom. Click Run anyway.
Keyboard Shortcuts
Whis-AI is designed for speed. Use these shortcuts to control the app without leaving your meeting window.
| Shortcut (Mac / Win) | Action |
|---|---|
| Cmd + \ Ctrl + \ |
Toggle Visibility Hide or Show the app instantly. |
| Cmd + K Ctrl + K |
Toggle Listening Start/Stop listening to system audio. |
| Cmd + Shift + C Ctrl + Shift + C |
Screenshot & Ask Captures current screen and asks AI for help. |
| Alt + Arrow Keys | Nudge Window Move the overlay window pixel-by-pixel. |
| Cmd + Enter | Send Message Manually send typed text. |
Permissions Setup
To capture meeting audio, the app requires specific system permissions.
1. Screen Recording (Audio Capture)
This is the most critical permission. It allows Whis-AI to "listen" to the audio coming out of your speakers (Zoom, Teams, etc.).
- macOS: Go to System Settings > Privacy & Security > Screen Recording. Toggle "Whis-AI" to ON.
2. Microphone Access
Used as a backup if system audio capture fails, or if you want to speak to the assistant directly.
Troubleshooting
Status says "Audio Access Denied"
The app failed to access the system audio.
Fix: Ensure you have granted "Screen Recording" permission in System Settings. If you just granted it, you must restart the app for it to take effect.
Sub-Overlay says "Active Plan Required"
You have hit the 10 free usage limit for the trial tier. You can check your status by clicking the Profile icon > Refresh Status.
Login window is stuck or blank
If the Google Login browser window doesn't redirect back:
1. Close the app completely (Profile > Close App).
2. Relaunch.
3. Ensure your firewall is not blocking localhost connections.
I can't find the app after minimizing
Use the global shortcut Cmd + \ (or Ctrl + \) to bring it back to focus. Check your system tray (top right on Mac, bottom right on Windows) for the Whis icon.