Guide
Set up CopperOS
CopperOS is a Chrome extension (the hands) and an AI agent (the brains). The agent runs in the cloud, where you sign in with Google and go, or on this computer, if you run the broker yourself.
Install the extension
Then click the CopperOS icon in Chrome's toolbar to open the side panel. If you can't see it, open the puzzle-piece menu and pin CopperOS.
Then pick how you want to run it:
In the cloud The quick way
Type a task in the panel and press Enter.
The first time, it asks you to sign up: press Continue with Google and sign in with your Google account. Your task starts as soon as you are in.
How long one task can run depends on your plan: up to 15 minutes on the trial, 5 hours on Ingot, 24 hours on Facet, and no limit on Foundry (see pricing). If a task reaches its limit, say continue and it picks up where it left off.
Want to use your own model?
Using your own key comes with the Foundry plan (see pricing). Choose it in Settings → Plans & credits (the sliders icon, top right). Settings then shows your own provider, key and model: choose a provider, paste your key, choose a model and press Save. Your key is used from then on:
- OpenRouter (openrouter.ai/keys): one key gives you hundreds of models, and you pay only for what you use.
- OpenAI (platform.openai.com).
With your own key, CopperOS puts no limit on your usage, and you pay your provider directly. Foundry covers the hosting and storage. To skip the plan, run CopperOS on your own computer with your own key or a local model.
On this computer Everything stays with you
You need Node.js 20 or newer (nodejs.org, the LTS installer is fine), and an OpenRouter or OpenAI key, or Ollama (ollama.com) with a model that supports tools.
Get the broker:
$ git clone https://github.com/Jesse0502/CopperOS.git $ cd CopperOS/broker $ npm installNo git? Download the ZIP from GitHub and unzip it. The folder will be called
CopperOS-main.Start it, and keep the terminal open while you use CopperOS:
$ npm startNext time you only need this step.
Open the CopperOS panel. Once the broker is running, the panel finds it and asks whether to switch to it, even if you are signed in to the cloud: choose Switch to this computer. No sign-up is needed. (Chose to stay? While the broker runs, Settings shows Cloud and This computer at the top: choose This computer.)
Open Settings (the sliders icon), choose your provider and model, and press Save. With Ollama, the model list comes from
ollama list.
Try it
Type this and press Enter:
›Open example.com and tell me what the main heading says
The tab it works in joins a CopperOS tab group, and Chrome shows "CopperOS started debugging this browser". That banner is how CopperOS clicks and types reliably.
Good to know
Approvals
The pill next to Send decides when this chat asks first: before every action, only before submits (the default), or never. Ask before in Settings sets it for new chats.
Supervisor
On long tasks, a supervisor checks in every few steps. Press Supervisor next to Send before you send a task to give it rules of your own, such as "only jobs posted this week, never LinkedIn".
Switching
While a broker is running on this computer, Settings shows Cloud and This computer at the top, to move between them. Each keeps its own chats.
Something not working?
The panel says "Start the broker"
You chose This computer, and the broker isn't running. Run npm start in CopperOS/broker, or choose Use the cloud instead.
It keeps connecting and disconnecting
On this computer, two copies of CopperOS are fighting over the broker, for example one in another Chrome profile. Keep one enabled.
The broker stops with EADDRINUSE
Another broker is already running on port 7331. Close the other terminal.
The model errors when it starts a task
Pick a different model in Settings. It must support tool calling.
More help: Support, or Settings → Send a suggestion in the extension.