{"id":35893253,"url":"https://github.com/browserbase/claude-code-plugin","last_synced_at":"2026-04-01T22:11:32.685Z","repository":{"id":330653269,"uuid":"1123480454","full_name":"browserbase/claude-code-plugin","owner":"browserbase","description":"Browserbase plugin for Claude Code - Use cloud browsers with Claude Code instead of local Chrome","archived":false,"fork":false,"pushed_at":"2025-12-27T03:32:17.000Z","size":119,"stargazers_count":63,"open_issues_count":4,"forks_count":10,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-15T19:59:32.350Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/browserbase.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-27T00:53:45.000Z","updated_at":"2026-01-15T19:31:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/browserbase/claude-code-plugin","commit_stats":null,"previous_names":["browserbase/claude-code-plugin"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/browserbase/claude-code-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserbase%2Fclaude-code-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserbase%2Fclaude-code-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserbase%2Fclaude-code-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserbase%2Fclaude-code-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/browserbase","download_url":"https://codeload.github.com/browserbase/claude-code-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserbase%2Fclaude-code-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31292637,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-09T11:00:36.028Z","updated_at":"2026-04-01T22:11:32.661Z","avatar_url":"https://github.com/browserbase.png","language":"JavaScript","readme":"# Browserbase Plugin for Claude Code\n\nUse [Browserbase](https://browserbase.com) cloud browsers with Claude Code instead of local Chrome.\n\n## What it does\n\nThis plugin intercepts Claude Code's browser automation commands (`mcp__claude-in-chrome__*`) and forwards them to Browserbase's cloud browser infrastructure. This gives you:\n\n- **Sandboxed, secure browser execution** - Run browser automation in isolated cloud environments\n- **Session recording and debugging** - Watch Claude browse in real-time via debug URLs\n- **Scalable browser automation** - Cloud browsers with built-in proxy and stealth capabilities\n\n## Requirements\n\n- [Claude Code](https://claude.com/claude-code) CLI\n- [Claude in Chrome](https://chromewebstore.google.com/detail/claude-in-chrome/fcoeoabgfenejglbffodgkkbkcdhcgfn) extension installed\n- [Browserbase](https://browserbase.com) account with API key\n- Node.js 18+\n\n## Installation\n\n### From Browserbase Marketplace\n\nIn Claude Code, add the plugin marketplace and install:\n\n```\n/plugin marketplace add browserbase/claude-code-plugin\n/plugin install browserbase@claude-code-plugin\n```\n\nThen restart Claude Code for the changes to take effect.\n\n### Manual Installation\n\n1. Clone this repository:\n   ```bash\n   git clone https://github.com/browserbase/claude-code-plugin.git\n   ```\n\n2. Copy to your Claude plugins directory:\n   ```bash\n   cp -r claude-code-plugin ~/.claude/plugins/browserbase\n   ```\n\n3. Install dependencies:\n   ```bash\n   cd ~/.claude/plugins/browserbase\n   npm install\n   ```\n\n## Setup\n\nRun the setup script to configure your Browserbase credentials:\n\n```bash\n~/.claude/plugins/browserbase/scripts/setup.sh\n```\n\nYou'll be prompted for:\n- **Browserbase API Key** - Get this from [browserbase.com/settings](https://www.browserbase.com/settings)\n- **Project ID** - Find this in your Browserbase dashboard\n\nCredentials are stored in `~/.browserbase/credentials`.\n\n### Alternative: Environment Variables\n\nYou can also set credentials via environment variables:\n\n```bash\nexport BROWSERBASE_API_KEY=\"your-api-key\"\nexport BROWSERBASE_PROJECT_ID=\"your-project-id\"\n```\n\n## Usage\n\nOnce installed and configured, just use Claude Code normally. The plugin automatically:\n\n1. **On session start**: Launches a cloud browser and starts the forwarding server\n2. **On browser commands**: Forwards all `mcp__claude-in-chrome__*` commands to Browserbase\n3. **On navigation**: Shows you the live debug URL to watch the browser\n4. **On session end**: Cleans up the browser session\n\n### Example\n\n```\n$ claude\n\n\u003e Navigate to github.com and take a screenshot\n\n[Browserbase] Cloud browser ready (server PID: 12345)\n[Browserbase] Watch live at: https://www.browserbase.com/sessions/abc123/debug\n\nI'll navigate to GitHub and capture a screenshot...\n```\n\n## How it works\n\n```\n┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐\n│   Claude Code   │────▶│ Forwarding Server│────▶│   Browserbase   │\n│                 │     │  (Unix Socket)   │     │  Cloud Browser  │\n└─────────────────┘     └──────────────────┘     └─────────────────┘\n         │                                                │\n         │              ┌──────────────────┐              │\n         └─────────────▶│ Claude in Chrome │◀─────────────┘\n                        │    Extension     │   (CDP over WebSocket)\n                        └──────────────────┘\n```\n\n1. Claude Code sends browser commands via the MCP browser bridge socket\n2. The forwarding server intercepts these commands\n3. Commands are translated to CDP (Chrome DevTools Protocol) and sent to Browserbase\n4. Browserbase executes commands on a cloud browser\n5. Results are returned through the same path\n\n## Plugin Structure\n\n```\nbrowserbase/\n├── .claude-plugin/\n│   └── plugin.json          # Plugin manifest\n├── hooks/\n│   └── hooks.json           # Hook configuration\n├── scripts/\n│   ├── setup.sh             # Credential setup\n│   ├── session-start.sh     # Starts forwarding server\n│   ├── session-stop.sh      # Cleanup on session end\n│   └── browser-tool-log.sh  # Shows debug URL on navigate\n├── index.js                 # Entry point\n├── forwarding-server.js     # Socket interception \u0026 forwarding\n├── browserbase-client.js    # Browserbase API \u0026 CDP client\n└── package.json\n```\n\n## Troubleshooting\n\n### \"Claude in Chrome extension not found\"\n\nThe plugin requires the Claude in Chrome extension to be installed, even though commands are forwarded to Browserbase. Install it from the [Chrome Web Store](https://chromewebstore.google.com/detail/claude-in-chrome/fcoeoabgfenejglbffodgkkbkcdhcgfn).\n\n### \"Failed to load credentials\"\n\nRun the setup script again:\n```bash\n~/.claude/plugins/browserbase/scripts/setup.sh\n```\n\n### Server won't start\n\nCheck the server logs:\n```bash\ncat ~/.browserbase/state/server.log\n```\n\n### Debug hook execution\n\nCheck the hook debug log:\n```bash\ncat ~/.browserbase/state/hook-debug.log\n```\n\n## Development\n\nTo test the plugin during development:\n\n```bash\nclaude --plugin-dir /path/to/browserbase-plugin\n```\n\n## License\n\nMIT\n\n## Links\n\n- [Browserbase](https://browserbase.com)\n- [Claude Code](https://claude.com/claude-code)\n- [Claude in Chrome Extension](https://chromewebstore.google.com/detail/claude-in-chrome/fcoeoabgfenejglbffodgkkbkcdhcgfn)\n","funding_links":[],"categories":["Claude Plugins"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowserbase%2Fclaude-code-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrowserbase%2Fclaude-code-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowserbase%2Fclaude-code-plugin/lists"}