easi.run
Self-hosted Chrome sessions for you and your AI agents
About easi.run
easi.run is an open-source tool that gives AI agents their own real Google Chrome, running on your own Linux server. Agents that work on the web need a browser, and most teams either rent hosted browser sessions by the hour or glue together headless Chrome and a VNC server. easi.run is a third option: one command starts it on your server, and from then on every agent gets an isolated Chrome, either fresh or with your saved logins, plus a live window where you can watch what it is doing.
The key idea is human takeover. When an agent hits something only a person can do, such as a password, a two-factor prompt or a CAPTCHA, it asks for you, and you take control of the session with one click while the agent waits. You hand control back and it carries on. Persistent sessions keep logins and site data between runs, encrypted with a key only your password unlocks. The project is written in Rust, ships with a built-in MCP server for Claude Code, Codex and other MCP clients, and is published on GitHub under the AGPL-3.0 license. There are no usage fees: you pay for your server and nothing else.
You install easi.run on a Linux server with Docker. The vendor provides an install prompt you can paste into Claude Code or Codex running on that server, or you can follow the quick start by hand. The installer can register the MCP server with Claude Code automatically. Your agent then opens sessions through MCP or the equivalent REST API, either locally, over SSH without a token, or over HTTPS with one token per agent. Each session is a sandboxed Chrome with its own containers and no access to your private network. You can watch sessions live, take over when the agent signals that it needs you, or skip and let it continue without you, and a signed webhook can notify Slack, Discord or your own tool. Each session keeps a timeline of the agent's actions and, with recording on, a replay of its screen.
- •Live human takeover - Take control of an agent's browser at a login, 2FA code or CAPTCHA, then give it back; the agent waits and resumes.
- •Persistent, encrypted sessions - Resume a session with your logins, site data, history and preferences, encrypted with a key only your password unlocks.
- •Built-in MCP server and REST API - Connect Claude Code, Codex or any MCP client, locally, over SSH or over HTTPS with per-agent tokens.
- •Sandboxed real Chrome - Every browser runs in its own containers with no route into your private network, using Google Chrome itself rather than a modified build.
- •Privacy guards on what you type - Password fields never reach the agent, and text you type during a takeover reaches it only as redacted.
- •Timelines, recording and files - Review each agent's actions, replay recordings, drag files in, receive downloads and use the clipboard both ways.
easi.run is built for developers and small teams running coding agents such as Claude Code or Codex that need to use real websites, including ones behind a login. It suits people who are tired of agents being logged out or blocked, and who would rather run browsers on a server they control than pay per hour for hosted sessions. Self-hosters who care about where credentials live will value the encrypted profiles and the rule that typed secrets never reach the agent. Teams automating research, testing or back-office web tasks can watch agents work and step in only when a person is needed. It requires comfort with running Docker on a Linux server.
