Custom cursor

Getting started

Install Juno, give it the permissions it needs, and run your first command.

On this page

What you need

The app itself is free.

  • A Mac running macOS 14 or newer, Apple silicon or Intel. Windows is not out yet; the Juno site has a list you can join.
  • An AI account. If you pay for Claude Pro or Max and have Claude Code installed, Juno can use that. Otherwise paste an API key from Anthropic, OpenAI, or Google.

Download and install

  1. Download the .dmg from junebug.ai or GitHub Releases.
  2. Open it and drag Juno into your Applications folder.
  3. Open Juno.

First launch

Every step can be skipped and finished later.

  1. Welcome. Click Get Started.
  2. Pick how Juno looks. This is the look of the bar.
  3. Connect Your AI. If Claude Code is installed and signed in, Juno shows "Detected and signed in" next to Use your Claude subscription. Pick it, or paste an API key instead. If Claude Code is signed out, run claude login in Terminal first.
  4. What Juno can do. The permissions below.
  5. Better dictation. Juno may offer to download a speech model that runs on your Mac. You can say Not now.
  6. You're all set. Juno shows you the key to hold, and lets you try it.

Permissions

Juno asks macOS for four permissions. It needs the first two before it can act in other apps.

PermissionWhy Juno asksNeeded?
AccessibilityLets Juno click, type, and move the cursor for you.Required
Screen RecordingLets Juno see what is on screen so it knows what to do.Required
MicrophoneLets you talk to Juno instead of typing.Optional
Input MonitoringLets your keyboard shortcut reach Juno from any app.Optional

Let Juno do it

  1. Start with Accessibility. Setup shows a short demo of the switch to flip.
  2. Once it is on, Juno offers Finish setup for me and turns on Screen Recording and Input Monitoring itself.

System Settings comes to the front while it works, and you can press Stop at any time. Prefer to do it yourself? Choose I'll do it myself.

Do it by hand

Open System Settings, go to Privacy & Security, pick the permission, and switch Juno on. Some changes only take hold after a restart. If Juno says it needs one, click Restart Juno.

Skip any of this with I'll do this later. macOS may also ask when Juno first touches your Desktop, Documents, Downloads, Calendar, Reminders, or Contacts. Those prompts are optional too.

Your first command

  1. Hold your talk key and say something simple, like "Open Safari". Let go when you finish.
  2. Or click the bar, type your request where it says Ask Juno, and send it.
Hold the talk key, say "Open Safari", let go.

Juno works in the background by default, so you can keep using your Mac.

Still stuck? Check the FAQ or write to support@junebug.ai.