Troubleshooting
Fixes for the most common problems with permissions, the microphone, shortcuts, and connecting an AI.
On this page
Juno cannot click or see my screen
Juno needs Accessibility and Screen Recording to act.
- Open System Settings and go to Privacy & Security.
- Open Accessibility and make sure Juno is switched on. Do the same for Screen Recording.
- If Juno says it needs a restart, click Restart Juno.
In Juno, Settings, Security & Privacy, the macOS Permissions section shows which permissions are granted and which are still needed.
My microphone is not working
- Check the Microphone switch for Juno in System Settings, under Privacy & Security.
- In Juno, open Settings and go to Audio. If something is wrong, Microphone and speaker opens by itself and shows Juno is not listening with the reason.
- Under Listen through, choose the microphone you want. The system default follows whatever your Mac uses.
My shortcut does nothing
- Input Monitoring is off. This lets your shortcut reach Juno from other apps. Switch Juno on under Privacy & Security, Input Monitoring.
- You tapped instead of holding. The default keys work by holding. A press shorter than about half a second is cancelled.
- The emoji picker opens instead. Open System Settings, go to Keyboard, and set "Press globe key to" to "Do Nothing".
- Your keyboard has no globe key. Juno uses other keys. See and change every key in Settings, under Shortcuts, or read Change your keys.
- Two shortcuts share a key. Juno does not allow that, and shows a message in Shortcuts. Give one a different key.
Juno does not answer, or says I am not signed in
Juno needs an AI to think with. In setup, Connect Your AI offers two ways:
- Use your Claude subscription. This needs Claude Code installed and signed in. If it shows "Installed but not signed in", run
claude loginin Terminal. If it shows "Not installed", get Claude Code first. - Paste an API key from Anthropic, Google, or OpenAI.
If you skipped this step, turn on Show advanced settings, go to Advanced and choose Restart onboarding. To change the provider later, open Settings and go to Providers.
A red dot on the bar means Juno cannot answer. It can say "Network unavailable", "Can't reach" your provider, or "Not signed in". Check your internet connection first, then sign in again.
Juno is not in my Dock
Juno may be set to show in the menu bar only. Click its menu bar icon, open Settings..., and turn on Show advanced settings. Under Advanced, set Show Juno in to Dock or Both.
I want to stop everything
Press esc. See Using Juno.
Still stuck? Check the FAQ or write to support@junebug.ai.