FAQ

Quick answers to common questions. Each answer links to the page with the full details.

About Headmaster

What is Headmaster?

Headmaster is an AI agent. It does more than chat. It can use tools, work with files, run tasks on a schedule and remember what matters to you. You use it in the desktop app or in web chat. See Introduction.

Is Headmaster free?

Yes, during the beta. No card is needed. Paid plans may come later, and we will tell you first. Providers you connect with your own keys bill you directly.

What plans or tiers are there?

There are two Headmaster models: Headmaster Lite, the fast default for every account, and Headmaster Pro, which is more capable for longer and harder tasks. Both have usage limits during the beta. See Models and providers.

What platforms are supported?

A Windows desktop app, and web chat at headmaster.gcaplabs.com in any modern browser. An iOS app is planned for later.

How do I sign up?

Public sign-up is closed during the beta. New Cloud accounts are approved one by one. Contact us to ask for access. You can sign in with email and password or with Google, in the desktop app and in web chat.

Cloud and Work

What is the difference between Cloud and Work?

	Cloud	Work
Where it runs	Your private hosted workspace	Your own PC
Your local files	Not reachable	Reachable, in the folder you choose
Works when your PC is off	Yes	No
In web chat	Yes	No

See Cloud and Work modes.

Which mode should I use?

Use Cloud for research, writing, scheduled tasks and anything you want to reach from anywhere. Use Work when the agent needs files or programs on your PC, such as a code project.

Do I need Cloud approval to use Work mode?

No. Work mode runs on your PC and works without Cloud approval.

Can I switch modes in the middle of a project?

Yes, at any time, with the mode switch in the desktop app. Your memory is shared, so the agent still knows your preferences. Files are not shared between modes: Work files stay on your PC, Cloud files stay in your Cloud workspace.

Models

Can I use my own models?

Yes. Sign in with ChatGPT or Claude, or add an API key from a supported provider. Your provider bills you directly. See Models and providers.

What happens when I hit a usage limit?

Headmaster tells you, and offers Connect your provider so you can keep going with your own model. Daily limits reset the next day. Monthly limits reset on the 1st.

Why did my model switch to Lite?

The model you were using is no longer available, for example because you removed its key. Headmaster switches to Lite and tells you. Pick another model in the model picker.

Memory

Does the agent remember me?

Yes. You have one memory for your account, shared by Cloud, Work and web chat. Tell the agent something once and it can use it everywhere. See Memory.

How do I make it remember or forget something?

Just ask. "Remember that I prefer short summaries." or "Forget my old address." You can browse what it remembers on the Memory page in Cloud mode.

Can anyone else see my memory?

No. Memory is private to your account.

Safety

Can the agent act without asking?

By default, no. Approval mode starts on Manual, which asks before actions that need approval. Smart asks only when needed, and Off runs without prompts. See Approvals and safety.

Can the Cloud agent touch my PC?

No. Cloud actions run in your Cloud workspace. Only Work mode can work with files on your PC.

Where do my messages go?

To the model you picked, so it can answer. With Headmaster models, that is our model service. With your own provider, it goes to that provider. See Data and privacy.

Everyday use

Can I reach my agent from my phone?

Yes, through web chat in a mobile browser, or through a messaging app you connect.

Can Headmaster do things on a schedule?

Yes. Ask it to run a task every morning, or every Monday, and it will. See Scheduled tasks.

Can I connect other tools?

Yes, through connections and MCP servers. See Connections and MCP servers.

How do I change the look?

Pick a theme in the desktop app settings. The default theme is Hello Kitty.

Account and updates

How do I update the desktop app?

When an update is ready, Headmaster shows Update ready. Choose Update now. Cloud and web chat are updated for you. See Updating Headmaster.

How do I delete my account?

Contact us. Deleting your account removes your Cloud workspace and your memory. To remove data from your PC too, uninstall the desktop app with Uninstall everything. See Data and privacy.

Something is not working. Where do I start?

See Troubleshooting. If you are still stuck, contact us.