How-to guides
Step-by-step Bandicot guides: first task, undo a run, nightly automation, secrets, Chrome, a second Mac, teams, sharing, Agent Macs and company rollout.
Available now. A current user-facing path exists within the stated scope.
Connect a model and run your first task
Connect one provider, open a folder, type a task in the prompt bar and read the cost of the run when it ends.
You need Bandicot installed (see Install) and either an account with a model provider or a local model. This guide uses a provider key. For a model that runs on your Mac, see Local models.
Everything the agent does is saved on your Mac, and each tool call is one row you can open.
- Open Home with a double tap of
⌘, then choose Account ›AI Gatewayand stay onProviders. - Find your provider's tile, paste the key and press
Connect, or press its sign-in button such asSign in with ChatGPT. - When the tile reads
ConnectedorSigned in, pressUsebeside one of its models. - Choose
File›Open Project(⌘O) and pick a folder you can afford to experiment in. - Type the task in the box that says
Ask Bandicotand press Enter. For example:Summarize every file in this folder in a file called notes.md. - Watch the rows. Open one to see what ran. If a card says
Needs your call, read it and chooseAllow onceorDeny. - Press
⌘1to open theContextpage and readAgent costandThis turn.
If it goes wrong
- The prompt bar says
Connect a provider to send · /connect. - Nothing is connected yet. Type
/connect, or finish the connection on theProviderstab. - The tile says
Needs attention. - Read the message on the tile and press
Retry,Sign in againorReplace key. See When connecting fails.
Plan a big change and let subagents do the parts
Ask for a plan, edit its steps, then let the agent start subagents for the parts and watch them in the Agents view.
A plan is the list of steps the agent works through, and you can add, edit, reorder or drop steps yourself. /plan researches first and writes the plan without starting the work. A subagent is another agent your agent starts for one piece of work, and it shows under its parent in the sidebar.
- In the prompt bar, type
/planfollowed by the change you want, and press Enter. - Open the Plan pane from the
Viewmenu and read the steps. Add a step inAdd a step…, or drop one you do not want. - Tell the agent to start. When it offers a subagent, read the brief on the card and choose
Start. - Open
View›Agentsto see each helper's task, status and anActivitybutton for its live log. - Line up more work with
New planunder the steps. A queued plan waits until the plan above it is finished.
If it goes wrong
- The Plan pane says nothing is planned.
- Add a step in the pane, or ask for a plan with
/plan.
Set up a project with Versions and undo an agent run
Turn on Versions for the folder before the first run, and any run can later be put back with Undo this run.
Versions saves a version of each file in the folder every time it changes, on your Mac. Agents keep working in a folder without Versions, but their changes are not recorded there, so turn it on first. Versions can only put back files in the folder: shell commands, web requests and files written elsewhere cannot be reversed, and the undo check lists them under Undo cannot take these back.
- Choose
New projectand give it aProject name, or open an existing folder withFile›Open Project. - Open Home › Versions with the project open, and wait while Bandicot looks at the folder. Nothing is copied yet.
- Read the counts for Kept, Left out by rule and Cannot be kept, then choose
Start keeping versions. - Ask the agent to do the work and let the run finish.
- Open the
Saved versionspage, select the run on the history line and chooseUndo this run. - In the check, untick any file you want to leave alone. For a file you edited after the run, choose
Keep current,Take pre-runorKeep both. - Choose
Undo the run. The undo is a new version, so you can undo it too.
If it goes wrong
- The page reads
Versions is off for this folder. - Choose
Review and start, thenStart keeping versions. - Your home folder is not kept.
- Versions does not keep the history of your home folder because it holds Bandicot's own data. Open a folder inside it.
Run a nightly automation and read its report
Create an automaton, add a schedule that repeats every twenty-four hours, keep the Mac awake and read Last report in the morning.
An automaton is an agent of your own with a name, a job and a model. It hands the real work to your agents and writes a report. A schedule repeats at an interval you set in whole minutes, so a run every twenty-four hours is 1440.
Runs that work in their own copy of the folder, such as scheduled automations, leave their changes on the Versions Review page until you apply or discard them. See Review changes from automations.
- Open Home › Team, then
Automatons, and chooseNew automaton. - Type a
Name, such asNightly check, and aJobthat says what to look at and what to do. ChooseCreate automaton. - Under
Schedules, chooseAdd schedule. Write theMessageeach run sends, setEvery (minutes)to1440, and leaveStop after (runs)at0to keep it running. - Under
Missed runs, chooseSkip themorCatch up, thenAdd schedule. - In the
Always oncard of the Automatons tab, turn onKeep working when Bandicot is closed. - In the morning, open the automaton.
Last reportreadsDone,Nothing to do,BlockedorNeeds you. - Choose a dot under
Runsto see what that run reported, andOpen conversationfor the full run.
If it goes wrong
- Nothing ran overnight.
- A Mac that sleeps runs the schedule when it wakes. Keep it awake with the controls in the
Always oncard, or let a second Mac cover it. See Always on. - A run reads
Needs you. - Open the automaton. A card above the message box asks for an answer or a permission. An ask that nobody answers is denied.
Give an agent a password or key safely
Share the value with Share a secret or keep it in the Passwords vault, and the agent gets a note that it exists, never the value.
A pasted key goes into the transcript and to the model provider, so do not type it into a prompt. When you share a secret, the agent gets a private file and a note naming it. The value does not reach the model, the logs or the events you see, and a message that holds a secret is never sent to someone else's Mac.
- In the prompt bar, open the attach menu and choose
Share a secret. - Type or paste the value and give it a
Name (optional). - Choose
Save securely, then send your message. The agent can read the secret only inside a command, for twenty-four hours. - For a login the agent should be able to use, open
Settings›Passwordsand add the sign-in. An agent can have it typed where you allow, and never sees the password. - When you are finished, choose
Forgeton aKept secret, orDeleteand thenDelete for goodon a vault entry.
If it goes wrong
- A card headed
Asking for a secretappears. - The agent needs a key it does not have. Fill the field and choose
Save securely, or chooseDecline.
Connect your own Chrome for a logged-in site
Install the Bandicot extension, choose Connect Chrome in Settings, and lend the one tab where you are already signed in.
The agent works only in tabs you lend it and tabs it opens itself, and the rest of your browser stays yours. It never types a password: when a page needs one it stops, the tab shows a blue edge and a Bandicot needs you card, and you type it yourself.
- Install the
Bandicotextension in Chrome. - In Bandicot, open
Settings›Computerand find theBrowsercard. - Choose
Your Chrome, thenConnect Chrome, and check that the dot readsChrome connected. - Open the page in Chrome and sign in if it asks.
- Click the Bandicot button in the Chrome toolbar. The badge shows
ON. - Tell the agent what to do in that page.
- Click the toolbar button again to take the tab back.
Pair a second Mac and answer an approval from it
Pair the Macs with a link and six matching digits, then answer an agent's permission card from whichever Mac is in your hand.
The first Mac holds your account key and is the only one that can pair, remove or make a recovery kit. The pairing link works once and counts down, so do the steps together.
- On the Mac you use most, open Team ›
Your Macsand pressStart with this Mac. This Mac is now taggedHolds the key. - On the same Mac, press
Pair a Mac. The card shows a pairing link, six digits and a countdown. - On the new Mac, open Team ›
Your Macs, choosePair with a Mac you already useand paste the link intoPairing link. - Check that both screens show the same six digits, then press
The digits match, pair. - On the Mac whose agents will ask, check that
Answer this Mac's requests from my other Macsis on. - When an agent there asks for permission, open Team ›
Your Macson the other Mac. The ask shows underYour other Macs. PressAllow onceorDeny.
If it goes wrong
- The digits do not match.
- Do not pair. Start again from
Pair a Mac, and make sure you copied the link from your own Mac. - A long command shows only
Deny. - A command too long to show in full can only be denied from the other Mac. Answer it on the Mac where it runs.
Start a team and invite someone
Start a team with a name, create an invite link for one person, send it privately and keep your Mac open until they join.
You become the owner and the coordinator of the team. The coordinator's Mac is the one that admits new people, so it must be open and signed in when someone joins.
- Open Home with a double tap of
⌘and chooseTeam. - Under
Start a team, type a name inTeam nameand pressStart team. The team starts with#general. - Under
Invite as, pickMember,GuestorAdmin, then pressCreate invite link. - Copy the link and send it to one person, privately. A link works once.
- Keep Bandicot open until they have joined. They paste it into
Invite linkunderJoin a teamand pressJoin team. - Type in
Message #generaland press Enter. The label under your message says where it has reached.
If it goes wrong
- The invite section is missing.
- Only the coordinator's Mac creates invites. Open Team on that Mac.
Lend a model to a friend
Make them a friend, switch on the model you will lend with a daily cap, and their agents use it on your key.
Only API keys and models on your Mac can be lent. A plan sign-in stays yours. Only the model call runs on your side: their tools, files and history stay on their Mac, and your key never leaves yours.
- Open Team ›
Friends, pressCopy my friend linkand send it to one person, privately. - They paste it into
Friend linkunderAccept their linkand pressAccept. - Open
Settings›Computerand findLent models. - Switch on the
Lend toswitch beside the friend, then switch on theLendswitch beside each model you are willing to lend. - Pick
Daily lent tokens, and watch theLent todaybar andWho borrowed today. - Your friend sees the model under
Lent to you, pressesUseand readsNew agents usethat model. - To stop, switch the model or the friend off, or press
Stop all guest work.
Set up Agent Macs
Build the template Mac once in Settings, finish its checklist, and every Agent Mac is copied from it.
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. It takes memory and disk, which the Resources card shows as bars.
- 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. - In its window, work down the checklist:
Finish macOS setup and sign in,Open BandicotGuest.app from the shared folder,Allow Screen Recording and Accessibility, andTurn off FileVault, then turn on automatic login. - Optionally add apps or a setup script on the
Starter kitcard, andSign in once on the template. - Choose
Finish setup. - Pick a
Resource mode:Light,BalancedorFull. - Turn on
Agents can use it, andAutomatons work on itif automations should use one. - Choose
Showto watch the Agent Mac's screen live.
Roll Bandicot out to a company
Start the company on the website, set the rules, invite people and hand IT the Mac profile and the download.
Pick Business. It includes 5 people, and the company page shows the exact amount before you pay. The person who starts it is the owner.
- Sign in on the website and open the company page.
- Choose the plan, the number of people and
YearlyorMonthlybilling. - Fill in the company name, your name and your role, and tick the agreement. Press
Sign and payand finish on the Stripe page. - Open the
Setuptab and work through the checklist: verify your domain, choose rules, invite people. - On the
Rulestab, set what every Mac follows, such asStay in the project folderorAlways ask before acting. - On the
Peopletab, type an email, choose a role and pressSend invite. - On the
Installtab, pressCopyto get the link for people, andDownload Mac profileto upload to your MDM. Add the Bandicot app from the download page to the same MDM group.
Save cost with a local model and the usage pane
Read where the tokens go, move small jobs to a model on your Mac, and set an allowance for the work Bandicot does on its own.
A model on your Mac costs nothing per ask, and small models are not a match for frontier models, so keep the hard tasks on a hosted model. Cost figures are estimates, not invoices, and your provider's bill is the source of truth.
- Press
⌘1and readAgent statson theContextpage:Agent cost,This turnandTokens processed. - Press
⌘8to open Efficiency and read what the agent spent onOverview. - Open Home, then Account ›
AI Gateway›Usage, and read spend by profile over seven, thirty or ninety days. - Press
⇧⌘M, pick a model underBest for this Macand pressDownload & use. - Under
AI Gateway›Decisions, press the name of a Laya model so quick questions cost nothing per ask. - In
Usage, type an amount inAutomatic AI allowance · USDand pressSave account limit. - On an Anthropic or OpenAI API key, turn on
Slow lane for automationsto run automation work at half price. It can take hours.
Move to a new Mac with the recovery kit
Make a recovery kit and a second copy on the old Mac, then restore the copy on the new one with the kit.
Bandicot does not keep your recovery words and cannot show them again, so write them down and keep them somewhere safe. Without the kit nothing in the copy can be read.
- On the Mac that holds the key, open Team ›
Your Macsand pressMake a recovery kit. Copy theRecovery wordsand theRecovery envelopeand store them safely. - Open Versions › Backups, choose
Type your recovery kit, type it twice, and chooseStart copies. - Answer
Keep a copyfor iCloud Drive or for a disk you plug in, and say yes when macOS asks once about iCloud Drive. - On the new Mac, turn on iCloud Drive with the same Apple Account, or plug in the disk.
- Open Versions › Backups ›
Restore your Bandicot historyand chooseLook for copies. - Type your recovery kit and choose
Open this copy. - For each project, choose
Choose folderand pick an empty folder, or leave it out. ChooseRestore. - Quit and reopen Bandicot to load the restored agents and settings.
If it goes wrong
- You lost the Mac that held the key.
- On a new Mac, open Team ›
Your Macs, pressRestore from a recovery kit, enter theRecovery wordsand paste theRecovery envelope.
Questions
Which guide should I read first?
Read the first one, which connects a model and runs a first task. Then turn on Versions on the same project, because that makes every later guide safer.
Are the button names exact?
They are the labels the app shows, in backticks. If a label on your screen differs, the app is newer than this page, so check the Troubleshooting page and the page for that feature.
Do these guides work on the Free plan?
Yes, except the ones that need a company or more profiles. Free has every capability of the app for one profile, and the company guide needs Business.
Where do I find what each setting does?
Every setting is explained on the Settings page, in the order the app shows them. Shortcuts are on Keyboard shortcuts.