Tabryn

Tabryn connects AI coding agents to the Chrome browser you're already using — existing tabs, existing sessions, real application state — through a universal MCP browser runtime.

Why Tabryn?

Browser automation traditionally means running a separate browser or profile. Coding agents need controlled access to the real development browser — the one with your logged-in sessions, your localhost tabs, your actual application state. Tabryn bridges this gap.

Features

Installation

# Clone and build
git clone https://github.com/idugeni/tabryn.git
cd tabryn
npm install
npm run build

# Set up native messaging host
node dist/cli/index.js install

Load Chrome Extension

1. Open chrome://extensions
2. Enable Developer mode
3. Click Load unpacked
4. Select the extension/ directory

That's it! Extension will auto-configure on first connection.

Add to MCP Client

claude mcp add tabryn -- node /path/to/tabryn/dist/mcp/index.js

{
  "servers": {
    "tabryn": {
      "command": "node",
      "args": ["/path/to/tabryn/dist/mcp/index.js"]
    }
  }
}

{
  "mcpServers": {
    "tabryn": {
      "command": "node",
      "args": ["/path/to/tabryn/dist/mcp/index.js"]
    }
  }
}

Verify

node dist/cli/index.js doctor

Architecture

┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  AI Agent   │────▶│  MCP Server │────▶│    Bridge   │────▶│   Chrome    │
│             │◀────│             │◀────│             │◀────│  Extension  │
└─────────────┘     └─────────────┘     └─────────────┘     └─────────────┘
     stdio               TCP            Native Messaging      DevTools API

Supported Agents:

Claude Code ─┐
Codex CLI ───┤
Kiro ────────┤
OpenCode ────┤
OpenClaw ────┼──→ Tabryn ──→ Your Chrome
Hermes ──────┤
Gemini CLI ──┤
Custom Agent ┘

Available Tools

Example: Development Workflow

┌──────────────────────────────────────────────────────────────────────────┐
│  Agent: Edit code → Run dev server → list_tabs → find localhost tab     │
│  Agent: screenshot → inspect UI → read_console → find errors            │
│  Agent: click → interact → reload → verify fix                          │
└──────────────────────────────────────────────────────────────────────────┘

CLI Commands

Configuration

Environment Variables

Security

Tabryn is designed with security as a first-class requirement:

• No credential exposure — Cookies, passwords, and session tokens are never sent to agents
• Permission boundaries — Users control which tabs are accessible
• Input validation — All messages are validated before processing
• Local-only communication — All traffic stays on localhost

See SECURITY.md for the full security model.

Architecture Decision Records

• ADR-0001: Communication Protocol — Why Native Messaging + TCP

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT © idugeni