Help
How can we help?
Short answers to what people ask most. Still stuck? Contact us. A person answers.
Installing
How do I install it on a Mac?
Download it from vassalagent.com/download, open it, and drag Vassal Agent into Applications. If your Mac says it can't check the app, the download page shows the clicks under If your computer shows a warning. You only do it once.
macOS says it can't open the app. What do I do?
Open System Settings, go to Privacy & Security, scroll down and press Open Anyway next to Vassal Agent, then confirm with your password. You only do this once.
Is there a Windows version?
Yes. Vassal Agent runs on Windows 10 and 11, and on Macs with macOS 12 or newer (Apple chip or Intel). The download page picks the right one for your computer.
Setting up
What does it need to know about me?
Nothing, to start. At the end of setup, press Let it learn and it reads what is already yours, such as your profile and your website, in a few minutes. After that it keeps learning from everything you tell it and every job. See, change or remove anything it knows on Your Vassal.
How do I connect my AI?
Pick Claude or ChatGPT on the setup screen. It installs what's needed in the background and opens the sign-in page in your browser. Sign in, come back, done: no commands to type. ChatGPT runs through OpenAI's Codex, signed in with your ChatGPT account. Other AI tools that speak MCP, such as Cursor, Windsurf, VS Code and Claude Desktop, can connect too: open Connect in the app and press Connect next to it.
Which AI plan do I need?
One you already pay for. On Claude, Claude Pro is enough for most people; the free Claude plan can't run the assistant. For ChatGPT you sign in with your ChatGPT account.
Do I need to sign in to my sites?
Only when a job needs one. If a job uses Gmail or LinkedIn and you are not signed in, it opens the site and asks you to sign in the usual way, then carries on. Your passwords stay on your computer and never reach us.
Using it every day
How do I give it a job?
Type what you want in the assistant box in plain words, like you would to a person. For example: find 30 companies in Miami hiring a head of sales and list the founders with links.
Can I see exactly what it is doing?
Yes. You see the AI's own output as it works, next to the browser on the same screen. Run several jobs at once in separate tabs; each tab shows whether it is working, waiting for you or done, and how many sub-agents are running.
Will it send or buy anything without asking?
No. Before it sends, posts, submits, pays or deletes, it stops and asks. Nothing happens until you press Allow. Every step it takes is listed under Activity.
It asks me too often. Can it ask less?
Yes. When it asks, press Allow for this job and it stops asking about that button on that site until the job is done, or Always allow here to stop asking for good (you can undo it in Settings, then Rules). Harmless buttons such as Search, Next and Save draft never ask. Paying and deleting always ask.
How do schedules and workflow results work?
Each workflow runs two ways: by hand, or on a schedule you set with the clock button on its row. Its latest result shows on that row, ready to click open, copy or continue in the chat. Workflows run while the app is open, or in the background when Keep running when closed is on.
How do I turn a job into a workflow?
Press Show it once on the Workflows screen and do the job yourself in the browser. It becomes a workflow, with what you typed turned into questions for next time. Passwords are never recorded. The same button re-teaches a workflow that stopped working.
Why does it suggest taking over a job?
It notices browser work you do again and again, using the tools you actually use, and offers to take it over as a workflow. It suggests at most one a day, and nothing changes unless you say yes.
How do I get results into a spreadsheet?
Under every table in the chat or on the Workflows tab: Copy as table, Save as spreadsheet, Send to Google Sheets (it opens a new sheet in the browser and fills it in) or Email it (a draft, never sent).
Can I set my own rules?
Yes. Settings, then Rules. Write them in plain words, like Never press "Send" on linkedin.com or Ask me before pressing "Pay". If your team shares rules, theirs come first and yours can only add to them.
Can my team share workflows and rules?
Not yet. Team accounts, where one owner shares workflows and rules with everyone, are on the way. Today each person has their own Vassal.
How does it learn?
From what you tell it, the moment you say it. From what is already yours: your profiles, your site, your documents. From the edits you make to its drafts, so it writes like you. From every job: it keeps the route it took, so the next time it goes straight there. Everything it knows is on Your Vassal, where you can change or remove any line.
Getting it and updates
How do I get it?
Contact us and we set it up for your business.
Do I need a license key?
No. Sign in to the app with the email we set you up with. There is no password: we email you a 6-digit code.
How do I move to a new computer?
Install it on the new one and sign in with the same email, then press Allow on your old one: everything you taught it comes across. No old computer at hand? Use your recovery code from Settings, On every computer. Sign an old one out on your account.
How do updates work?
They install themselves. The app downloads a new version in the background and switches to it the next time you quit and open it.
If something goes wrong
It says the assistant isn't signed in.
Open Connections and press Sign in under Your AI. If it keeps happening, sign out of your AI (Claude or ChatGPT) and sign in again when the app asks.
A site logged me out.
Open that site in the app's browser and sign in again. Some sites sign you out every few weeks for security.
Does the app send crash reports?
Only if you turn them on in Settings, then Advanced. They are off unless you do. A report holds the error, the app and system version and a few log lines with links, file paths, emails and anything like a key removed. It never includes the pages you visit, what you ask the assistant or what you type.
A job stopped halfway.
Check its row on the Workflows tab and the chat for what it managed and why it stopped. Press Run again, or tell it what to do differently. It keeps what it learned.
I still need help.
Contact us. A person answers.
Ten minutes from now, it is working.
We built it to run our own business, and we set it up for yours.