Kitsune¶

Delegate browser tasks. Keep your browser yours.
Kitsune connects Claude Code, Codex, Pi and other MCP clients to the Firefox, Zen or LibreWolf browser you already use. It's built for personal browser tasks—researching products, comparing pages, and drafting forms—rather than cross-browser testing. Your agent opens its own background tabs while you keep working in yours.

Your agent asks for a tab. You approve, then take it back. Watch the 45-second demo →
Why Kitsune?¶
I built Kitsune after getting tired of switching back to my tab whenever my Playwright setup took focus, and opening Chrome for my agent when I already used a Firefox-based browser. I wanted browser automation that worked alongside me, not in my way.
- Keep working while the agent works. Agent-created tabs open in the background. Selecting a tab for the agent doesn't switch the tab you see.
- Your tabs stay yours. By default, the agent can read your tabs but cannot type, navigate, scroll or close them. It must request a handoff before changing one; you approve and can take it back.
- Stay in Firefox, Zen or LibreWolf. Reuse your existing sessions without opening a separate Chrome browser or installing WebDriver.
- A small tool surface. Six tools on
main, with Python for browser actions and direct controls for user help and recovery. The 0.8.0 release has 14.
Kitsune is designed to reduce interruptions, not eliminate them: site-opened popups and OS-level trusted input can still move focus. See the shared-browser limits.
Less input. Broader tasks.¶
The 6-tool Kitsune used the least total input in this four-way comparison. 23 personal and UI conditions, two repeats; all four configurations completed 46/46 attempts.
Codex gpt-6.1-sol, medium. Input includes cache, not billed cost. Browser environments and permissions differ. 6-tool adjusted time was 4.8% higher than 14-tool Kitsune and 6.6% higher than Aside; results vary by task. Results, methodology and limitations →
Get started¶
- Install uv.
- Install the browser extension in Firefox, Zen or LibreWolf.
- Add Kitsune to your agent. For Claude Code:
claude mcp add --scope user kitsune -- uvx --from kitsune-browser-mcp kitsune
Codex, Pi, OpenCode, Claude Desktop and Cursor are in Installation. 4. Keep the browser open and ask in plain language:
Research these three products in background tabs and compare them with links. Leave my current tab alone.
Fill in a draft of this form. Don't submit it.
Trust note: Python runs locally, not in a sandbox; set KITSUNE_SCRIPTING=0 to disable it.
Approvals do not prevent prompt injection. Use a separate profile for sensitive accounts and
read the security guide.
Documentation¶
The full documentation is at junyeong-nero.github.io/kitsune:
- Installation: every MCP client, version pinning, upgrades
- Your tabs and approvals: what limits the agent: protected tabs, per-tool approvals, ask-before-act
- Tools: the minimal and legacy tool lists, and the tool groups
- Python API: drive the browser from your own scripts with
pip install kitsune-browser - Troubleshooting · FAQ · Benchmarks · API reference