browsentic

https://github.com/user-attachments/assets/307afa62-5fbd-47ac-822c-baee491ddfe3

<div align="center">

# Browsentic – a completely integrated agentic browser extension

<p>
  <a href="https://www.npmjs.com/package/browsentic"><img src="https://img.shields.io/npm/v/browsentic?logo=npm" alt="npm version"></a>
  <a href="https://www.npmjs.com/package/browsentic"><img src="https://img.shields.io/npm/dm/browsentic?logo=npm" alt="npm downloads"></a>
  <a href="https://github.com/imshaikot/browsentic/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/imshaikot/browsentic/ci.yml?branch=main&label=CI&logo=githubactions&logoColor=white" alt="CI"></a>
  <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/browsentic?logo=nodedotjs&logoColor=white" alt="node"></a>
  <a href="LICENSE"><img src="https://img.shields.io/npm/l/browsentic" alt="license"></a>
</p>
<p>
  <a href="docs/guide/install.md"><img src="https://img.shields.io/badge/manifest-V3-4285F4?logo=googlechrome&logoColor=white" alt="Manifest V3"></a>
  <a href="https://github.com/imshaikot/browsentic/releases/latest"><img src="https://img.shields.io/github/actions/workflow/status/imshaikot/browsentic/release.yml?label=macOS%20build&logo=apple" alt="macOS build"></a>
  <a href="https://github.com/imshaikot/browsentic/releases/latest"><img src="https://img.shields.io/github/actions/workflow/status/imshaikot/browsentic/release.yml?label=Windows%20build&logo=data:image/svg%2Bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0iI2ZmZiIgZD0iTTAgMy40IDkuOCAydjkuNUgwek0xMSAxLjggMjQgMHYxMS41SDExek0wIDEyLjVoOS44VjIyTDAgMjAuNnpNMTEgMTIuNWgxM1YyNGwtMTMtMS44eiIvPjwvc3ZnPg==" alt="Windows build"></a>
  <a href="https://github.com/imshaikot/browsentic/releases/latest"><img src="https://img.shields.io/github/actions/workflow/status/imshaikot/browsentic/release.yml?label=Firefox%20build&logo=firefoxbrowser&logoColor=white" alt="Firefox build"></a>
</p>

**No account · No auth · No API key · No cloud · No telemetry · Local first**

Your real, logged-in browser, driven from an AI side panel by the agent CLI you already have.<br>
Also an optional [MCP server](docs/guide/mcp-clients.md), so any MCP client can drive the same browser.

<p>
  <strong>Works in</strong><br>
  <a href="docs/guide/install.md"><img src="https://browsentic.com/icons/chrome.svg" width="40" height="40" alt="Chrome" title="Chrome"></a>&emsp;
  <a href="docs/guide/install.md#firefox"><img src="https://browsentic.com/icons/firefox.svg" width="40" height="40" alt="Firefox" title="Firefox"></a>&emsp;
  <a href="docs/guide/install.md"><img src="https://browsentic.com/icons/edge.svg" width="40" height="40" alt="Edge" title="Edge"></a>&emsp;
  <a href="docs/guide/install.md"><img src="https://browsentic.com/icons/brave.svg" width="40" height="40" alt="Brave" title="Brave"></a>&emsp;
  <a href="docs/guide/install.md"><img src="https://browsentic.com/icons/arc.svg" width="40" height="40" alt="Arc" title="Arc"></a>
</p>
<p>
  <strong>Runs on</strong><br>
  <a href="https://claude.com/claude-code"><img src="https://browsentic.com/icons/claude.svg" width="40" height="40" alt="Claude Code" title="Claude Code"></a>&emsp;
  <a href="https://developers.openai.com/codex/cli"><picture><source media="(prefers-color-scheme: dark)" srcset="https://browsentic.com/icons/openai-dark.svg"><img src="https://browsentic.com/icons/openai.svg" width="40" height="40" alt="Codex" title="Codex"></picture></a>&emsp;
  <a href="https://antigravity.google/docs/cli/install"><img src="https://browsentic.com/icons/antigravity.svg" width="40" height="40" alt="Antigravity" title="Antigravity"></a>&emsp;
  <a href="https://github.com/mistralai/mistral-vibe"><img src="https://browsentic.com/icons/mistral.svg" width="40" height="40" alt="Mistral Vibe (beta)" title="Mistral Vibe (beta)"></a>&emsp;
  <a href="https://docs.x.ai/build/overview"><picture><source media="(prefers-color-scheme: dark)" srcset="https://browsentic.com/icons/xai-dark.svg"><img src="https://browsentic.com/icons/xai.svg" width="40" height="40" alt="Grok Build (beta)" title="Grok Build (beta)"></picture></a>&emsp;
  <a href="https://cursor.com/docs/cli/overview"><picture><source media="(prefers-color-scheme: dark)" srcset="https://browsentic.com/icons/cursor-dark.svg"><img src="https://browsentic.com/icons/cursor.svg" width="40" height="40" alt="Cursor CLI (beta)" title="Cursor CLI (beta)"></picture></a>&emsp;
  <a href="https://qwenlm.github.io/qwen-code-docs/en/"><picture><source media="(prefers-color-scheme: dark)" srcset="https://browsentic.com/icons/qwen-dark.svg"><img src="https://browsentic.com/icons/qwen.svg" width="40" height="40" alt="Qwen Code (beta)" title="Qwen Code (beta)"></picture></a>&emsp;
  <a href="https://opencode.ai/docs/"><picture><source media="(prefers-color-scheme: dark)" srcset="https://browsentic.com/icons/opencode-dark.svg"><img src="https://browsentic.com/icons/opencode.svg" width="40" height="40" alt="OpenCode (beta)" title="OpenCode (beta)"></picture></a>
</p>

</div>

## Quick Start

**Any platform** — with [Node.js](https://nodejs.org) 20 or newer (Windows is [experimental](docs/guide/limits.md#windows-is-experimental)):

```sh
npx browsentic setup
```

**macOS** — one line installs [Browsentic.app](docs/guide/mac-app.md), which brings Node and everything else:

```sh
curl -fsSL https://browsentic.com/install.sh | sh
```

**Windows** — one line in PowerShell installs [the Windows app](docs/guide/windows-app.md), which brings Node and everything else ([experimental](docs/guide/limits.md#windows-is-experimental)):

```powershell
irm https://browsentic.com/install.ps1 | iex
```

Full install and setup guide, Firefox included: **[browsentic.com/docs/guide/install](https://browsentic.com/docs/guide/install/)**

## Key Capabilities

<table>
  <tr>
    <td>🧭 <a href="docs/guide/features/conversations.md"><b>Side panel, human in the loop</b></a></td>
    <td>🤖 <a href="docs/guide/agents.md"><b>Every major agent CLI</b></a></td>
    <td>🎯 <a href="docs/guide/features/page-actions.md"><b>50+ deterministic tools</b></a></td>
  </tr>
  <tr>
    <td>🌐 <a href="docs/guide/install.md"><b>All Chromium + Firefox</b></a></td>
    <td>🗺️ <a href="docs/guide/features/page-actions.md#moving-around"><b>Full browser navigation</b></a></td>
    <td>🧩 <a href="docs/guide/features/captcha.md"><b>Solves captchas on the way</b></a></td>
  </tr>
  <tr>
    <td>📄 <a href="docs/guide/features/files.md#files-you-hand-it"><b>Reads files, acts on them</b></a></td>
    <td>↕️ <a href="docs/guide/features/files.md#download-here-upload-there"><b>Uploads & downloads</b></a></td>
    <td>🧠 <a href="docs/guide/features/site-maps.md"><b>Creates its own skills</b></a></td>
  </tr>
  <tr>
    <td>⚡ <a href="docs/guide/features/page-actions.md#repeating-a-job-and-doing-what-no-tool-covers"><b>Writes & runs live tools</b></a></td>
    <td>🎙️ <a href="docs/guide/features/recordings.md"><b>Voice, text or show it once</b></a></td>
    <td>👁️ <a href="docs/guide/features/a-eye.md"><b>Point at what you mean</b></a></td>
  </tr>
  <tr>
    <td>⏱️ <a href="docs/guide/features/scheduling.md"><b>Monitors & schedules</b></a></td>
    <td>🛡️ <a href="docs/guide/approvals.md"><b>Guardrails & approvals</b></a></td>
    <td>🔌 <a href="docs/guide/mcp-clients.md"><b>Optional MCP server</b></a></td>
  </tr>
</table>

## How It Works

![How an instruction becomes a click](https://browsentic.com/flow.png)

<details>
<summary>The same flow, as text</summary>

```
You ──speak or type──> Extension ──local WebSocket──> Daemon ──spawns──> your agent CLI
                            ▲                              (claude │ codex │ agy │ vibe │ grok)
                            └──────────────── page actions ─────────────────────┘

Any MCP client ──stdio──> browsentic mcp ──> the same daemon ──> the same browser
```

</details>

The extension dials out to the daemon, because a Manifest V3 service worker cannot listen for connections. One daemon owns the browser link, so several MCP clients can share one browser. Everything binds to `127.0.0.1`.

## Resources

- 📚 [Documentation](docs/)
- 🚀 [Install and Pair](docs/guide/install.md)
- ✨ [Features](docs/guide/features/)
- 🧰 [All 52 Page Tools](docs/reference/tools.md)
- 🔌 [Optional: Drive It From Claude Code, Cursor or Zed Over MCP](docs/guide/mcp-clients.md)
- 🛡️ [Approvals and Guardrails](docs/guide/approvals.md)
- 🏗️ [Architecture](docs/internals/)
- 🩺 [Troubleshooting](docs/guide/troubleshooting.md)

## Privacy and Security

Nothing connects until you pair, both ends prove themselves, consequential actions ask first, and credentials on a page are sealed before the agent sees them. The full model is in [SECURITY.md](SECURITY.md), and what it does not cover is in [Limits](docs/guide/limits.md).

## Contributing

Bugs and ideas are welcome — start at [CONTRIBUTING.md](CONTRIBUTING.md).

## License

Browsentic is MIT licensed.

- **Source Available**: Always visible source code
- **Local First**: No cloud component, no telemetry, no account
- **Extensible**: Add your own page capabilities, skills and agent runners

## What does Browsentic mean?

**Short answer:** "Browse" + "agentic".

**Long answer:** Most browser automation asks you to hand the work to a *different* browser — a headless one, in a container, logged in to nothing. Browsentic is the other way round: the agentic part happens in the browser you are already looking at, with the sessions you are already signed in to. The name is the thesis — browsing, made agentic, where you already browse.