Chapter 03 : The settings that matter

Most users never open Settings. Yet that is where Jay becomes an agent that knows you, and where you decide how far it can go on your Mac. Half an hour is enough, and every session after that benefits.

Chapter 03 · 6 min read

Settings is a place like any other: you get there through your avatar at the bottom of the icon bar, and Esc takes you back to where you were. The "Search settings" field is always open.

The settings that change everything

SettingWhat it changesWhere to find it
Job profileWhat Jay knows about you in every session: who you are, your rules, the setup it installsSettings, Jobs
Default access levelHow much autonomy a session starts with: Ask, Auto or Full. Two settings: default access (the one for Code) and default access in Work, set to Full out of the boxSettings, AI behavior
Terminal commandsThe commands that are always allowed, and those always refused, even with Full accessSettings, AI behavior
Reply languageAutomatic, or fixed: French, English, Spanish, German, Italian, PortugueseSettings, AI behavior
BrowserWhat Jay can do on the sites it visits, in the Browser as well as in the Web tabSettings, Browser
NotificationsWhen Jay alerts you through macOS, and the warning before the usage limitSettings, Notifications
UsageHow much you have used this week and this month, by source and by modeSettings, Usage
Lock with Touch IDJay locks when it opens, or when the Mac locksSettings, System
Keep Mac awakeKeeps the Mac awake at all times, screen open or even lid closed, so your flows and watches keep runningSettings, System, Power & startup

The job profile: your ID card

If you were to change only one setting, it would be this one. A job profile tells Jay who you are and how you like to work, across all your sessions. It also carries a setup: the Skills and connectors that go with your job, which Jay offers to install (chapter 11). You can have several profiles, for example one for your business and one for a nonprofit.

Put inLeave out
What doesn't change: your job, your industry, your audience, your technical level, your language, the answer format you prefer, the mistakes that annoy youWhat changes often: current projects, this month's clients, the instructions for a specific task. All of that goes in the project's JAY.md (chapter 4)
PROMPTGenerate your profile in 10 minutes
Ask me 8 questions, one at a time, to understand my job, my recurring tasks, my audience, my technical level, my tools, and how I like to receive an answer.
Then write a profile of 150 words maximum, in the first person, that I will paste into my job profile. Put first whatever changes the quality of your answers the most. End with the rules you should always follow with me, in 5 lines.
EXAMPLE· Profile

"I'm the marketing manager at a B2B industrial SME. I write for technical buyers. Reply in English, directly, with short lists and concrete examples. My working files are in Documents/Marketing; put everything you produce in the subfolder for the month. When you're not sure, say so. No introductory phrases and no closing summary. If my request is unclear, ask a question before you start. Never delete a file without showing it to me."

The Settings page, section by section

Application: the app and your account.

  • General. Appearance and accent color, the interface language, input and dictation, incognito sessions by default, the detail shown when a turn ends.
  • System. Touch ID, updates, storage (clearing caches), app health, power.
  • Notifications. When Jay notifies you through the macOS Notification Center, quiet hours, and "Warn before the limit": never, or at a percentage of your usage.
  • Keyboard shortcuts. Click a shortcut to change it.
  • Account. Your profile, your subscription ("Manage my subscription"), local backup, the installed version, signing out.
  • Usage. Your quotas (this week, this month, the Expert cap), your footprint, and charts over 7 days, 30 days or 12 months, by source or by mode. The app no longer shows amounts in euros: it counts in tokens, like your plan.
  • Archive. Sessions put away off the rail, and automatic archiving of inactive sessions. They stay on this Mac, ⌘K finds them, and opening one unarchives it.
  • Lab. Early-access features, open to a few accounts, with one switch per feature: today, sync across devices, external APIs (your own keys with other model providers) and full Google access. If you don't see this section, your account doesn't have access.
  • Release notes. What changed with each update.

AI: what shapes Jay while it works.

  • AI behavior. The reply language, the two default access levels, the default mode, the personality, your custom instructions, global memory, the allowed or refused terminal commands.
  • Models Status. Real-time model availability, checked every 60 seconds. If a mode is answering poorly, look here before looking anywhere else.
  • Jobs. Your job profiles.
  • Browser. Jay's rules on the web (chapter 9).
  • Transcription. The proper names and terms Jay mishears in meetings, so they get corrected automatically (chapter 12).

Code: what only matters for code.

  • Git. How Jay writes its commit messages, branches and pull requests (chapter 15).
  • Forges. Your Git servers: GitHub, Forgejo, GitLab, Bitbucket.
  • DOPE. Coding agents in a container, with your Jay account, on every Jay plan.

Privacy and incognito sessions

The models. The models that power Jay are open source and hosted in France. Nothing is sent to their publishers, and nothing is used to train a model. The footer of the mode picker says so, and dev-id's privacy policy names every model.

What stays on your Mac. Your sessions, your projects, your pieces and your meetings live on your Mac. Sync across devices (sessions, Atelier pieces, brand kits, meetings, projects) is in the Lab, open to a small group of accounts: it asks for your consent, given per device, and a cloud in the icon bar shows its status. Even when it's on, three things never leave the machine: your secrets (keys, tokens), anything that grants power (hooks, MCP servers, access level, allowed commands) and anything specific to this Mac. Archives stay on the Mac too.

Incognito sessions. A session can be incognito: the icon at the top of the home screen starts it that way. Nothing is saved, it disappears when you leave it, along with its files, and it isn't synced. The text is still sent to the model, whose gateway may keep it for 30 days, and usage is counted. Useful for a one-off or personal topic. Image mode isn't available there.

Your settings checklist

  • Job profile filled in and reviewed
  • Both default access levels on Ask while you learn (Work's is set to Full out of the box)
  • Terminal commands to refuse listed (deleting, sending, publishing)
  • Warning before the usage limit turned on
  • Two connectors plugged in (chapter 10)
  • Browser rules checked (chapter 9)
  • Touch ID turned on if your Mac is shared