Agent Macs
Give an agent a machine of its own so it can use apps and a screen without touching your windows. Set up the template Mac, pick a size and watch one work.
Available now. A current user-facing path exists within the stated scope.
What Agent Macs are
An Agent Mac is a virtual Mac that runs inside your Mac, so an agent can open apps, click and type on a screen of its own while your windows stay untouched.
Computer use on your own screen shares it with you. An Agent Mac does not: the agent gets its own desktop, and you can watch it or ignore it. Work that needs a Mac, such as an app that only runs on macOS, goes there.
Next to it, each agent can also get its own Debian Linux machine. Bandicot copies it in seconds and keeps its screen off until a page needs one. Both are controlled from the same card, Agent machine, in Settings.
Agents never see your passwords on either machine. You sign in once on a template Mac, and every Agent Mac copied from it starts signed in. See Secrets and passwords.
Where to find them in Settings
Open Settings › Computer, where the Agent machine card turns Agent Macs on and the Resources card shows what they cost your Mac.
The cards in that pane run in this order: Agent machine, Resources, shared Macs, lend, Window manager, Browser and Computer use. Shared Macs and lending belong to Shared Macs; Window manager and Computer use are described in Terminal and browser; Browser is covered with your Chrome.
The Agent machine card shows the macOS version, a grid of sizes, a grid headed Agent Macs in use and the setup timeline. Two switches decide who may use it: Agents can use it and Automatons work on it. Turning the first on says Agent machine on and Agents can use it now.
The state word on the card is one of Not installed, Not supported, Ready, Starting, Not set up, On or Off. The buttons are Start, Show and Save.
If it goes wrong
- The card says
This Mac cannot run a virtual Mac. - This Mac does not support virtual Macs. The rest of Bandicot works as before, and the Linux machine and the other tools are not affected.
- The card says
Reinstall Bandicot to add the agent machine. - Your copy of Bandicot came without it. Download Bandicot again from Install and replace the app.
Set up the template Mac once
Choose Set up on the Agent machine card and Bandicot builds one template Mac that every Agent Mac is copied from.
The rule is simple: sign in once on the template, and every Agent Mac copied from it starts signed in. Agents never see your passwords.
Bandicot does the long parts by itself: Download macOS from Apple, Install macOS, Start the template Mac, then it waits for you at Finish in its window, and ends with Save the template. The macOS download is large, about twenty-four gigabytes, and Bandicot removes the installer when the template is done.
Each step you take has a Risk and safeguard fold that says what the step changes and why it is safe. Turning off FileVault applies to the template Mac only, never to yours.
While it waits, the card reads The template Mac is waiting for you. If you pause, Save for later stores it. When it ends the card says Setup did not finish and offers Retry.
- Open
Settings›Computerand chooseSet upon theAgent machinecard. - Wait for the download and install. When the card reads
The template Mac is waiting for you, chooseOpen the Mac. - Do
Finish macOS setup and sign inin its window. - Do
Open BandicotGuest.app from the shared folder. - Do
Allow Screen Recording and Accessibilityfor it. - Do
Turn off FileVault, then turn on automatic login: press Turn Off, then Turn Off Encryption, turn on automatic login, and in Lock Screen set Require password to Never. - Optionally do
Sign in once on the template, for the sites and accounts every agent should start with. - Choose
Finish setup. Bandicot saves the template and the Agent Macs can start.
If it goes wrong
- The card reads
The agents' template Mac is not set up. - Choose
Set up. Nothing else can start until the template exists. - The card reads
The template Mac was saved to free memory. - Choose
Open the Macto bring it back, then continue with the step that is open. - The card reads
Setup did not finish. - Choose
Retry. It continues from the last stage that finished.
The starter kit
The Starter kit card lets you add apps, files or a setup script, and every new Agent Mac starts with them.
It sits on the Resources card. The text on it reads: add apps, files or a setup.sh, and every new Mac starts with them. Open folder shows the kit in Finder. Apply takes your changes to the template Mac, and Starter kit is on the template Mac confirms it.
Opens at start lists the apps every Mac opens when it starts. Type the app as Finder names it, in Add an app, as Finder names it, up to twelve apps. The switch Lighter Mac makes every copy lighter.
Passwords stay in the password manager and never go in this folder. A password is not part of a kit and is not copied with it. See Secrets and passwords.
Choose a size: Light, Balanced or Full
The Resource mode setting picks how big each Agent Mac is and how soon it is saved when idle, from Light to Balanced to Full.
Each mode says how many cores and how much memory an Agent Mac gets, how many run at a time, how long one may sit idle before it is saved, and how long the template waits for you before it is saved. The numbers are on the card, so you see them before you pick.
Balanced is the usual choice and leaves at least half of your Mac's memory and processor for you. Light is smaller and saved sooner. Full is the largest and waits longest.
A size applies when an Agent Mac next starts fresh, not to one that is already running. Under memory pressure, heat or a low battery Bandicot lowers the mode by one step for you, and a Recent list on the card says when it did.
Apple lets two virtual Macs run at once, so the others wait their turn as saved Macs. An Agent Mac whose sign-in is waiting for an answer is saved after a while that depends on the mode, between ten and ninety minutes, so it does not hold memory for nothing.
| Mode | Size of each Agent Mac | Saved when idle |
|---|---|---|
Light | Smallest | Soonest |
Balanced | Middle, and leaves half of your Mac free | After a moderate wait |
Full | Largest | Latest |
Watch an Agent Mac work
Choose Show on the card, or Watch on an automaton, to see an Agent Mac's screen live, and Window to open it in a window of its own.
The picture reads Waiting for a frame or No picture yet until the Mac draws something. Smaller shrinks the view. Beside it are counts: wakes, on Mac, shots and commands, and a bar that shows how many of the agent's actions were commands and how many were screenshots.
You can watch and not touch. Choose Open the Mac when you need to do a step yourself, such as signing in once, and the agent waits.
Saving and resuming
Save stores an Agent Mac as it is and frees the memory, and Resume or Start brings it back where it stopped.
The state word says where each Mac is: Running, Starting, Saved, Stopped, Waiting or Not created. A Mac saves itself after it has been idle for the time its mode allows, and you can press Save at any moment. Only the two most recently saved Macs keep what was open; an older one starts fresh next time.
Each agent's Mac is made the first time that agent needs a screen, and it is removed with the agent. The Agent Macs list on the Resources card has the details for each: Size now, Next fresh start, Saved when idle and a Run row.
Who uses them
Your agents use Agent Macs when Agents can use it is on, and your automatons use one when Automatons work on it is on.
An agent uses the machine when it needs a screen. An automaton has its own Mac card on its page, which starts by itself once the template Mac is set up; see Where an automaton works.
Turning a switch off stops new use of the machine by that kind of work.
What they cost your Mac
The Resources card shows your processor, memory and disk as bars split into Bandicot, everything else and free, with each Agent Mac listed under them.
The bars are CPU, Memory and Disk. Each is divided into Bandicot, Everything else and Free, so you can tell whether a slow Mac is Bandicot's doing. Pick Light if the free share is small.
Disk is the part to plan for. Every Agent Mac is a copy of the template, and the macOS download is large while it is being made. See Settings for the other panes.
Questions
Does an agent on an Agent Mac see my passwords?
No. You sign in once on the template Mac, and the copies start signed in. Passwords you save in Bandicot stay sealed, and an agent only learns whether a value went in.
Can I use my own screen instead?
Yes. Computer use on your own Mac stays available in Settings › Computer. An Agent Mac is for work you would rather not do on your own desktop.
Why is the first start slow?
The template Mac has to be downloaded and set up once. After that, an Agent Mac is a copy and starts in seconds.
Do Agent Macs work on any Mac?
Only on a Mac that supports virtual Macs. The card says This Mac cannot run a virtual Mac. when yours does not.