Chapter 01 : Getting started with Jay

Jay is an agent that lives on your Mac. It reads, writes, analyzes, codes, and above all it acts: in your folders, in your browser, in your apps and in your online tools. It runs on open source models hosted in France, and nothing you give it is sent to the companies that make those models.

Chapter 01 · 9 min read

Some screenshots show the app in French; the English interface has the same layout.

Most people start by asking it questions, one at a time. That's the use that pays off the least. Jay shows what it can really do when you open a folder for it and hand it a complete job: the goal, the context, the tools, and the freedom to come back with a finished result.

What changes with an agent on your computer

An online assistantJay
You send it a fileIt opens the folder itself, reads what's inside and saves its work there
It gives you text to copyIt writes the document, spreadsheet or presentation, and the file exists on your disk
It describes what you should do on a websiteIt opens the site in its Browser, clicks, fills in, and shows you
It forgets between conversationsIt remembers, and finds your past sessions and meetings
It stops when you close the tabIts Flows run on schedule, even with the window closed

This power comes with a trade-off: Jay can modify files and act on your behalf. That's why every action goes through an access level you choose: Ask, where Jay asks before each action, Auto, or Full (chapter 13).

Installing it

Jay is a macOS app for Apple Silicon Macs (macOS 12 or later). You install it from the DMG file provided by dev-id, like any other app: drag it into Applications, open it, sign in.

The welcome tour on first launch: six screens, starting with your job.
The welcome tour on first launch: six screens, starting with your job.
  1. Onboarding. On first launch, Jay introduces itself in six screens: your job, one session for everything (with the modes), Jay working for you (the Browser, your apps), you staying in control, your accent color, then your profile. Don't skip the first or the last one: your job and your profile shape every answer that follows (chapter 3).
  2. Updates. Jay updates itself. In Settings, System, Updates, you choose between "Install automatically" (when you quit or when Jay is idle) and "Ask me". A badge at the bottom of the icon bar signals that a version is ready, and "What's new" opens once after each update to tell you what changed.
  3. The lock. If other people get near your Mac, turn on "Lock with Touch ID" in Settings, System: on opening, or on opening and whenever the Mac locks.

Which plan to choose

Every Jay plan unlocks the same features: all the modes, images, the Browser, DOPE. The only thing that changes from one plan to the next is the volume of work. Paid plans are monthly, with no commitment: a cancellation takes effect at the end of the paid month. Prices are on the website and in Settings, Account. Oreus subscribers have their own plan, purchased from Oreus on top of their subscription.

PlanWhat it unlocks
Jay TrialAll features, with a one-time allowance of one million free tokens, with no time limit, to try Jay on real work
Jay ProAll features, with a weekly and monthly volume for daily use
Jay UltraThe same, with much more volume
Jay GigaThe same, with the most volume, for people who run Jay all day
OreusFor Oreus subscribers, purchased on app.oreus.ai: Jay and your Oreus agents in the same bar; DOPE is not included

Modes: which one for which task

Jay isn't a single model but a family of modes. Each mode has a stable name and a promise; the open source model behind it is shown in the picker, and it can change when a better model comes along. The more powerful a mode, the slower it is and the more of your volume it uses. The right habit: Adaptive for everyday work, Thinking or Expert for what really matters.

ModeIts promiseWhen to use it
AdaptivePicks the right mode for each requestBy default. You stop thinking about it.
VersatileFor everyday workRoutine writing, tidying up, most tasks; at Minimal effort, quick answers
ThinkingHandle complex tasksAnalyses, decisions, calculations, long tool-heavy tasks
ExpertMost capable, for demanding projectsWhat has to be right the first time

The old Fast mode has merged into Versatile: choose Versatile at Minimal effort to get the same instant answer. A session left on Fast reopens on its own in Versatile Minimal.

Effort. For the modes that reason, a second setting, effort, decides how much time the model spends thinking before it answers: Minimal, High (the default), Max. In Adaptive, it's called Automatic and sets itself. Raise the effort for a decision, lower it for a rewording. A separate row, Ultra intelligence, makes Jay follow a stricter method: it rereads its work with a critical eye when a doubt remains, and runs the tests itself for a change it hasn't verified. It uses more volume; save it for work that can't afford mistakes.

Images. The picker also has an Image models group: Fast (FLUX.2-klein-4B) to iterate, Thinking (Ink 1.4) when the image has to carry crisp text (chapter 6).

A tour of the interface

Jay's window is a frame and a card. The frame is the icon bar on the left: the places. The card is everything else: the place's sidebar and the work area.

The “+” in the bar: Add, then Do. Below it, the Work / Code switch, the project and the access level.
The “+” in the bar: Add, then Do. Below it, the Work / Code switch, the project and the access level.
ElementWhat it isWhat you do there
The icon barJay's places: Home, Meetings, Flows, Browser, Atelier, then, below the divider, Customize. All are pinned by default; the "···" button lists them and lets you unpin some.Switch places. At the bottom: Mini Jay, the update, your account and Settings.
The sessions railIn Home: your projects, your pinned sessions, your sections."New session", "New meeting".
The message barA single bar, for everything. It only shows what's there: your files, the project, a mode that's on, a card from Jay.The "+" adds (files, linked folder, Skills) and does (Plan, Image, an Atelier piece). Below it: the Work / Code switch, the project and the access level: Ask, Auto, Full.
The mode pickerThe right engine for the session.Change mode and effort. The bottom of the menu reminds you where the models run.
The drawerThe right half of the session; a row of buttons in the header opens each panel.Session info, Activity, Web, Files, Code, Terminal, Atelier, and, depending on the session, Design System or Brand kit.
⌘KThe single search.Find a session, a meeting, a skill, an app, even archived.
Mini JayThe companion, the question mark at the bottom of the bar, or ⌘⇧J.A quick question, about Jay or anything else, without keeping anything.

Work or Code. There is now only one type of session: you chat in it, write documents in it, code in it. A switch, at the top of the drawer under the bar, only changes what it shows. In Work, the bar offers Atelier pieces and images; in Code, it shows the branch, the isolated copy, the diff and a Terminal button, and the "+" offers Plan. Nobody has to choose before writing: a session whose folder is a Git repository starts in Code, all others in Work, and you switch whenever you like, without losing anything. Each position keeps its own access level (chapter 13). A project without a folder also exists: it's for organizing sessions.

Your first hour with Jay

Start with what changes the quality of answers the most, then move straight on to a real task.

  1. Fill in your job profile. Settings, Jobs: who you are, your rules, the equipment Jay installs for you. Five minutes, and every answer benefits (chapter 3).
  2. Create your first project with a folder. A client, a recurring report, a monitoring topic. Jay keeps its memory, documents and meetings there (chapter 4).
  3. Connect two tools. Your calendar and your email, for example, from Customize, Applications. Jay will be able to prepare your day (chapter 10).
  4. Run a real test, in Ask access. Take a real task from your week, the longest one, and hand it entirely to Jay with the brief from chapter 2. A Work session starts in Full access: for this first test, switch its access picker to Ask, and reread every permission card. That's how you learn what it does.
  5. Open the drawer. The Activity panel shows what Jay is doing right now, the Files panel what it has written. A single block closes each turn: the summary, the question it's asking you, the files produced, the time and the tokens. You'll always know where it stands.
PROMPTYour very first session
I've just started using Jay. I'm a [your job] and I spend most of my time on [your 3 main tasks]. My work files are in [folder].
Ask me 5 questions to understand my work. Then suggest the 5 uses of Jay that would save me the most time this week, ranked from simplest to most ambitious, each with an example message to send you and what you would need to be able to open (folder, tool, website).