zenpilot
Let Claude use your Zen Browser, like Claude in Chrome. No extension, only sites you allow.
Install / Use
claude mcp add beSaif -- npx -y github:beSaif/zenpilotIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AutomationSupported Platforms
Tags
Our assessment of zenpilot
zenpilot scores 78/100 on our quality scale, 2532nd of 2,780 Automation skills we index.
Its MCP Server is 6.5 KB long, well organised into 9 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated yesterday, so zenpilot is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
zenpilot compared with similar skills
All 4 of these similar skills score higher than zenpilot; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| zenpilot (this skill)by beSaif | 78 | 10 | 1d ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.3k | 9d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install zenpilot?
- Run
claude mcp add beSaif -- npx -y github:beSaif/zenpilot. The install tabs above show the steps for each supported agent. - Which AI agents does zenpilot work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is zenpilot safe to use?
- It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is zenpilot still maintained?
- The repository was last updated yesterday, so zenpilot is actively maintained.
Skill content
View source on GitHubLet Claude use your Zen browser. Works with Claude Desktop and Claude Code, kind of like Claude in Chrome but for Zen.

There's no browser extension. zenpilot opens Zen with its remote control turned on and talks to it directly.
Alpha. Built and tested on macOS with Zen 1.23. Linux support is newer: it's been tried on NixOS (Wayland) with Zen 1.23.
Install
You need a Mac with Zen in /Applications, or Linux with Zen installed (on PATH, in /opt/zen,
~/.local/share/zen or as the Flatpak). If zenpilot can't find it, set ZENPILOT_ZEN to the
command that starts it.
Linux: popups use zenity (or kdialog) and notify-send, so install one of them. Without
any, zenpilot can't ask you, so allow sites ahead of time with zenpilot allow <site>.
Claude Desktop has no Linux app, so use Claude Code.
Claude Desktop: download zenpilot-<version>.mcpb from the
latest release and open it. That's it.
Claude Code (or both): with uv installed, run:
uv tool install zenpilot
zenpilot setup
Setup asks which Zen profile to use and which sites Claude may visit. Then it connects zenpilot to Claude Code (and Claude Desktop, if you have it) and opens Zen. Restart Claude Desktop afterwards.
Either way, zenpilot updates itself to the newest release each time Claude starts it. To stay
on one version with uv, install it pinned: uv tool install zenpilot==0.5.0.
Use it
Just ask Claude: "order a large pizza with bacon on httpbin.org/forms/post for Sam, then submit it".
The first time, a few popups may show up. Only you see them, not Claude:
- Which profile?
zenpilotis a fresh profile that isn't logged in to anything. Pick your own profile if you want Claude to use sites you're logged into. - Reopen Zen? If Zen is already open without remote control, zenpilot offers to restart it. Your tabs come back on a Mac; on Linux, tabs you opened in the last few seconds may not.
- Allow this site? Claude only works on sites you allow. Choose Don't Allow, Allow
for 12 Hours or Always Allow. If you miss it, it asks again next time. After Don't
Allow it waits 10 minutes before asking again, or run
zenpilot allow <site>.
Pressing Enter always picks the safe answer.
While Claude works in a tab, an orange glow goes around the page and a zenpilot badge in the bottom-left corner says so. Press Stop on it and Claude stops and asks you what to do. If it tries again anyway, a popup asks whether to let it continue.
Claude can open, switch and close tabs, go to a URL, read the page and its console errors, click,
type, pick from dropdowns, hover, press keys, wait for text or a URL, scroll and take screenshots.
It can attach files to upload, but only from folders you list in upload_dirs. It can't touch
cookies, passwords or downloads, and it can't run its own JavaScript.
When it gets stuck
zenpilot is far from perfect, and every site is different. When Claude can't do something
(say, drag and drop), it notes what it tried. zenpilot also notes tool calls that failed or
took over 5 seconds. If anything went wrong, a notification at the end of the session points
you to a report in ~/.local/state/zenpilot/reports/.
zenpilot report # show the latest report
zenpilot report --issue # open a GitHub issue with it filled in
What you typed and the pages' text stay out of it, Claude is asked to leave out personal data,
and URLs lose their ?query part. Still, read it before you submit.
Staying safe
- Allowlist. Claude only works on sites you've allowed. Add one with
zenpilot allow github.com. - Stick to the
zenpilotprofile if you can. It's logged out of everything. On your main profile, a shady page could try to trick Claude into doing stuff in your accounts, so only allow sites you trust. - Read-only mode. Set
read_only = trueand Claude can look but not click or type. - Log. Everything Claude does is written to
~/.local/state/zenpilot/audit.jsonl, with what it clicked. Typed text isn't logged, only its length.zenpilot logshows it as a timeline. - Remote control is open while Zen runs this way. Other apps on your computer could connect to it too, and some sites (banks, Cloudflare checks) may think you're a bot. When you're done, quit Zen and open it normally.
zenpilot also stops Zen from switching off its own protections (Safe Browsing, the popup blocker and so on), which would otherwise happen when remote control is on.
Commands
| Command | What it does |
|---|---|
| zenpilot setup | Set everything up (see above) |
| zenpilot allow [site...] | Allow sites. --remove takes them off (12-hour ones too). No sites lists them. |
| zenpilot launch | Open Zen with remote control on |
| zenpilot doctor | Check your setup and say how to fix anything that's broken |
| zenpilot report | Show the latest session report. --issue files it on GitHub, --list lists them all. |
| zenpilot log | Show what Claude did lately. -n 200 for more, --errors for failures only |
Settings
They live in ~/.config/zenpilot/config.toml, and changes apply right away. See
all settings.
Good to know
- Only one Claude can drive Zen at a time. zenpilot lets go after 2 minutes of doing nothing, so Claude Desktop and Claude Code can take turns.
- Zen can be hidden or behind other windows. It still works.
- Zen loads restored tabs lazily, so Claude only sees an old tab once you've opened it.
- Stuck? Run
zenpilot doctor. If Zen says it already has a session after a crash, restart Zen.
Hacking on it
Setup and test commands are in docs/dev/hacking.md.
License
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
