Setup

Download, drag,
answer the cards

A signed, notarized Mac app with everything inside. No terminal, no build step. Five minutes from download to the first thing she does for you.

Built for Apple Silicon (M1 and newer). Intel Macs are not supported yet.

macOS 12 Monterey or newerApple SiliconGoogle ChromeA Gemini keyOptional: Claude, Codex or Grok
Install

Three steps

Open the disk image

Double-click Justyne.dmg. A window opens with Justyne and an Applications shortcut.

Drag, then open

Drag Justyne onto Applications and double-click her there. She starts her backend and opens the welcome cards.

Answer the welcome cards

Allow the microphone, screen and Mac control she asks for, then paste your Gemini key in Settings, Voice. Say "Hey Jarvis" and she is listening.

Her voice

One key, free to start

Her ears and mouth are a Gemini Live session on your own key. Paste it once in Settings, Voice, and she remembers it on your Mac.

Required

Gemini API key

Free from Google AI Studio. It powers the live conversation: listening, answering out loud and looking at your screen when you ask.

  • Stored on your Mac, never sent to us
  • Free tier to start

Your agents

Bigger jobs go to agents that run on the Claude, Codex or Grok app already on your Mac, on the login you already have.

  • Optional
  • No new accounts or API bills
macOS permissions

Four switches, each with a reason

The card opens the exact System Settings pane for each one and tells you when it is granted. Nothing is requested that she does not use.

Microphone

To hear you. Audio goes to the live socket while she is awake and nowhere while she sleeps.

Privacy & Security → Microphone

Accessibility

Real mouse and keyboard, and answering a permission prompt in a Terminal window with a keystroke when you say yes.

Privacy & Security → Accessibility

Screen Recording

One downscaled screenshot when you ask her to look. Never on a timer, never saved, never sent anywhere but the model answering that one question.

Privacy & Security → Screen Recording

Automation

AppleScript to Chrome, Terminal, Keynote and the Adobe apps. macOS asks the first time she reaches each app.

Privacy & Security → Automation
Troubleshooting

If something is off

"Justyne is damaged and can't be opened"
The release build is signed and notarized by Apple and opens without a warning. If you were handed an unsigned test build instead, right-click the app and choose Open once; macOS remembers the choice.
She cannot hear me
Check Microphone in System Settings for Justyne, and that your Gemini key is saved in Settings, Voice. The orb brightens when she hears sound; if it stays still, the microphone is the problem, not the key.
She hears me but answers with silence
Check that your Gemini key is saved in Settings, Voice, and that you still have free quota at Google AI Studio. If a reply stops halfway, say it again; she reconnects on her own.
Chrome things do not work
Chrome must be installed and, for a site, signed in once by you. The first time she reaches Chrome, macOS asks for Automation, say Allow. The Connections page lists every site and whether it is ready.

Ten minutes from now

Download, drag, open, talk.