Run a cloud agent

Run your coding agent on a machine of its own, with every tool its workspaces allow. It keeps working when you close the tab, and you can pick the session up from any device.

1

Pick the agent

In the console, open Agents, then Hosted, and click Add agent. Choose Run an agent, then the agent it should run.

Each one is the vendor's own CLI, installed by the vendor's installer and left as it is, so every way it signs in still works. Its machine comes with git, the GitHub CLI, Node and Python, enough to clone and build a typical repository, and Go, Rust, Java or Ruby install when a project asks for them.

2

Choose where it runs

Run the agent on a machine you already have, or order a new one. The list shows how much memory each machine has free and whether its CPU, memory and disk are healthy. A machine without room for another agent is listed as unavailable.

Order new asks for a region in the EU or the US, the type, the architecture and the size. A shared machine shares a physical core and can burst to full speed, but isn't built for continuous heavy load. A dedicated one keeps its cores to itself. Arm gives you physical cores and roughly 1.5 times the performance. Sizes run from 512 MB to 8 GB, and each shows its monthly price before you order.

Machines are paid up front. You are charged for the month when one starts, prorated to the time you use it, and anything unused returns to your balance.

Sharing a machine is your choice. Everything on one machine shares one security boundary. Give an agent a machine of its own when its credentials should stay apart from the rest.

3

Name it and give it room

Give the agent a name, add any variables it needs, and set how much of the machine's memory it gets. Then click Create agent.

Variables hold the keys the agent needs for its own work, such as GH_TOKEN for GitHub, or an API key for your model provider if you sign in with one. The agent gets them when it starts, so a change applies at its next start.

An agent needs at least 512 MB, and OpenCode 1 GB. Give it more for builds and long sessions. An agent that runs out of memory stops, and its page says why.

4

Open its terminal and sign in

Once the agent is ready, click Connect next to its terminal. The agent is already running. Sign it in the way you would on your own computer, with your own plan or key.

AgentSigns in with
Claude Code/login, with a Claude plan or an Anthropic API key
Codex/login, with a ChatGPT plan or an OpenAI API key
Copilot CLIA Copilot plan, by a code you confirm in your browser, or a GitHub token
Cursor CLIYour Cursor account, by a link you open, or a Cursor API key
Gemini CLIA Gemini API key, or Vertex AI
GooseYour model provider and its key, set in goose configure
Grok BuildA SuperGrok or X Premium+ plan, by a code you confirm, or an xAI API key
OpenCodeAny provider's API key, or a GitHub Copilot or SuperGrok sign-in

The agent is yours alone. Only the person who creates an agent can open its terminal, so only you sign it in and type into it. Teammates see that it exists. Owners and admins can stop, restart or delete it, but never see its variables.

5

Connect it to your workspaces

On the agent's page, pick the workspaces it may use, one at a time. Pick one and Meandr handles the rest. The agent sees every tool those workspaces allow, and every call it makes goes through their policies and approvals, like any other agent.

A new connection applies when the agent restarts. Restarting keeps the conversation, so the agent carries on from where it was.

6

Give it work, then leave

Ask the agent for something in its terminal and close the tab. It keeps working, around the clock, for as long as it exists. Nothing stops it for being idle.

Come back from any browser, on your laptop or your phone, and connect to its terminal again. It is the same session, right where it is. Opening it on one device takes it over from the other, which then offers to reconnect, so you can switch devices whenever you like.

Its state lives on its machine. Repositories, sign-in and conversations stay in the agent's home folder on the machine's disk. They survive restarts and stops, and last as long as the machine does. If the machine is deleted or has to be replaced, they go with it, so push work you want to keep. Deleting the agent deletes its home too.

7

Keep an eye on it

Every tool call the agent makes shows in the workspace's traffic under its name, with the tool, the rule that decided and how long it took. Calls your policies mark for approval wait for a person, wherever the agent runs.

The agent's page shows its machine too, so you can see when it needs more room. From there you can restart or stop the agent, give it more memory or a bigger machine, or delete it. A new size or machine restarts it at once.

Next steps

Run a cloud MCP server

Give your agent tools that run on Meandr too: a database, a browser, your own server.

Read the guide

Write your first policy

Decide what your agents may do: allow a call, deny it, or ask a person first.

Read the guide

Connect an agent

Running an agent on your own computer instead? Give it your workspace URL.

Read the guide