Ask Brello PI for a setting in plain words and it changes it itself, reads it back from macOS, says only what macOS now reports, and offers Undo, which puts back the value it read before. You don’t need to know where a setting lives in System Settings. Big things, such as restarting, ask first. This needs the agent, which runs on a Mac with Apple silicon, macOS 27 and Apple Intelligence.
Ask for a setting
Type it plainly in the Ask bar (⌥⌘1) or the popup (⌥Space):
| You type | What happens |
|---|---|
| “turn on dark mode” | Dark appearance, read back: “Your Mac is in Dark Mode now.” |
| “set the volume to 30%”, “mute” | The volume or mute on the current output |
| “hide the Dock”, “make the Dock smaller”, “move the Dock to the left” | The Dock’s hiding, size or position |
| “show hidden files”, “show file extensions”, “show the path bar” | Finder’s views; Finder restarts quietly to show them |
| “save screenshots to Pictures”, “save screenshots as JPG” | Where screenshots are saved, and their format |
| “turn off Wi-Fi” | Wi-Fi off; macOS may ask for an administrator first |
| “set my wallpaper to this picture” | The wallpaper on every display |
| “make Safari my default browser” | macOS asks you to confirm, as it always does |
| “keep my Mac awake for 2 hours” | See Keep your Mac awake |
| “lock the screen”, “turn off the display” | Done at once |
Each reply says what macOS reports now, with Undo.
Questions work too. “Is dark mode on?” gets a straight answer. Ask how to do something, such as “how do I make the Dock hide automatically?”, and Brello PI answers in one line, with a button that does it: “I can turn on Dark Mode for you.” and Turn On. Nothing changes until you press it or say yes.
What asks first
Sleep, restart, shut down, log out and emptying the Trash. The Trash’s question says how many items and how much space. None of them runs with nobody at the Mac.
What no app may change
Brightness, Bluetooth, Night Shift, a Focus, the accent color, Auto appearance, the firewall, FileVault, passwords and apps’ access. macOS keeps these for you alone. For these, Brello PI opens the exact pane in System Settings and says so in one sentence. It never claims to have changed them.
The first time
The first time you ask for a setting that goes through System Events or Finder, such as Dark Mode or the Dock, macOS asks whether Brello PI may control them. Choose OK. Locking the screen may ask for Accessibility, on a Mac whose display doesn’t lock as soon as it sleeps. See What macOS asks, and why.
Undo, and turning it off
Undo on the reply puts back the value Brello PI read before changing it, and reads it back again. It’s also in Activity (⌘5). Acts such as locking the screen have nothing to undo.
In Brello PI’s Settings, Open and quit apps “Lets Brello PI control your apps and settings when you ask.” Turn it off and Brello PI changes no settings and opens no apps; it opens the right pane instead.
Keep your Mac awake
- In the Ask bar or the popup, type how long, the way you’d say it:
- “keep my Mac awake for 2 hours”
- “keep my Mac awake until the download finishes”
- “caffeinate for 45 minutes”
- “keep the screen on for an hour”
- Press Return.
- Brello PI keeps the Mac awake, reads it back from macOS, and replies with when it ends, with Undo.
A cup and the time left appear beside Brello PI’s icon in the menu bar. Click it to see “Keeping your Mac awake”, with when it ends.
- For a while: say how long, in minutes or hours, and it ends on time.
- Until a download ends: Brello PI holds it until the download in progress is done.
- Neither, as in “keep my Mac awake”: it stays awake until you let it sleep or Brello PI quits.
- The screen too: asking for the Mac keeps it from going to sleep on its own, while the screen may still dim and turn off as usual. Name the screen, as in “keep the screen on”, and Brello PI keeps the display awake too, for a presentation or a video call.
To let it sleep early, choose Let It Sleep, or Undo on the reply, or ask: “let my Mac sleep”. It also always ends when Brello PI quits, so you can’t leave your Mac awake by mistake.
Brello PI holds a power assertion, the same mechanism the caffeinate command and apps like Amphetamine use, with macOS’s own timer for when it ends. Nothing in your settings changes: System Settings ▸ Battery and Lock Screen stay exactly as you set them. You can see the assertion in Health’s Sleep card, which lists what is keeping your Mac awake, in each app’s words and for how long.
When it doesn’t stay awake
- You closed the lid. Keeping a MacBook awake doesn’t stop it sleeping when you close the lid, unless it’s connected to power and an external display, as macOS allows. To keep a download going, leave the lid open.
- You pressed the power button or chose Sleep from the Apple menu. A power assertion stops the Mac sleeping on its own, not when you put it to sleep.
- The battery ran low. macOS sleeps a MacBook to protect it.
- Brello PI quit. The hold ends with it. Open Brello PI and ask again.
On a Mac where the agent can’t run, use the caffeinate command in Terminal, such as caffeinate -t 7200 for two hours. See How to keep your Mac awake.
A setting didn’t change
After every change, Brello PI reads the setting back from macOS. If it isn’t what you asked for, Brello PI says so instead of claiming it did, and puts it back as it was. Check these:
- macOS asked a question, and the answer was no. Settings such as Dark Mode and the Dock go through System Events, and emptying the Trash goes through Finder. macOS asks once whether Brello PI may control them. If you chose Don’t Allow, open System Settings ▸ Privacy & Security ▸ Automation, find Brello PI, and turn on System Events and Finder. Then ask again.
- Open and quit apps is off. Turn it on in Brello PI’s Settings. With it off, Brello PI opens the right pane instead of changing the setting.
- It’s a setting no app may change. See the list above. Brello PI opens the pane for you and says so.
- The Mac needs an administrator. Some Macs require an administrator’s password to turn Wi-Fi on or off. macOS asks; if you cancel, nothing changes.
- Something else set it back. A management profile from your work or school, or another app, can hold a setting. Brello PI reports what macOS says after the change.
| Setting | If it didn’t change |
|---|---|
| Dark or Light | Automation for System Events; if Appearance is set to Auto, macOS switches by the time of day; set it to Light or Dark in System Settings first |
| The Dock | Automation for System Events |
| Finder’s views | Finder restarts to show them; open windows close and come back |
| Default browser | macOS asks you to confirm; if you chose to keep the current one, nothing changes |
| Volume | Some outputs, such as HDMI displays, have no volume a Mac can set |
| Locking the screen | Accessibility, on a Mac whose display doesn’t lock as soon as it sleeps |
Reset a macOS question
If you can’t find Brello PI in the Automation list, the question may not have been asked yet: ask for the setting again, and macOS asks. To ask again from scratch, an administrator can reset Brello PI’s permissions with tccutil reset AppleEvents ai.brello.mac in Terminal, then open Brello PI and ask for the setting.
Still not changing?
Write to hey@brello.ai with what you typed and what Brello PI replied. Help ▸ Email Support… fills in your Brello PI and macOS versions.
Still stuck? Write to hey@brello.ai with what you typed or clicked and what you saw.