claude-chrome-parallel 3.0.3 → 3.4.0

package/README.md

@@ -1,464 +1,398 @@
-# Claude Chrome Parallel
-
-> **Run 20+ Claude Code browser sessions simultaneously, without conflicts.**
-
-[![npm version](https://badge.fury.io/js/claude-chrome-parallel.svg)](https://www.npmjs.com/package/claude-chrome-parallel)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/shaun0927/claude-chrome-parallel/main/assets/demo.svg" alt="Chrome Extension vs Claude Chrome Parallel - Animated comparison showing how Chrome Extension fails with 'Detached' error while Claude Chrome Parallel runs 5+ sessions simultaneously" width="100%">
-</p>
-
----
-
-```
-┌─────────────────────────────────────────────────────────────────────────────┐
-│                                                                             │
-│   Claude Code 1 ─► Worker A ─► [Tab1] [Tab2] ─┐                            │
-│                    (Google account)            │                            │
-│                                                │                            │
-│   Claude Code 2 ─► Worker B ─► [Tab3] [Tab4] ─┼─► Chrome (single instance) │
-│                    (Naver account)             │     Port 9222              │
-│                                                │                            │
-│   Claude Code 3 ─► Worker C ─► [Tab5] [Tab6] ─┘                            │
-│                    (Amazon account)                                         │
-│                                                                             │
-│   ✓ Each Worker has isolated cookies/session/storage                       │
-│   ✓ No more "Detached" errors with concurrent sessions                     │
-│   ✓ Multiple account logins on same site simultaneously                    │
-│                                                                             │
-└─────────────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Core Features
-
-<table>
-<tr>
-<td width="33%" valign="top">
-
-### 🔀 Worker Isolation
-
-Each Worker has a **completely isolated browser context**.
-
-- Separate cookies/sessions
-- Separate localStorage
-- Separate login states
-
-**Log into multiple accounts on the same site simultaneously!**
-
-</td>
-<td width="33%" valign="top">
-
-### ⚡ Parallel Execution
-
-Run tasks across multiple tabs/Workers **at the same time**.
-
-```
-Sequential: 1500ms
-  Tab1 ████░░░░ 500ms
-  Tab2     ████░░░░ 500ms
-  Tab3         ████░░░░ 500ms
-
-Parallel: 500ms
-  Tab1 ████░░░░
-  Tab2 ████░░░░
-  Tab3 ████░░░░
-```
-
-</td>
-<td width="33%" valign="top">
-
-### 🔄 Workflow Orchestration
-
-**Automatically distribute** complex multi-site tasks.
-
-```
-workflow_init({
-  workers: [
-    {name: "amazon", ...},
-    {name: "ebay", ...},
-    {name: "walmart", ...}
-  ]
-})
-→ 3 sites run in parallel
-→ Results auto-collected
-```
-
-</td>
-</tr>
-</table>
-
----
-
-## Comparison
-
-| | Chrome Extension | Claude Chrome Parallel |
-|---|:---:|:---:|
-| **Concurrent Sessions** | ❌ 1 (Detached error) | ✅ **20+** |
-| **Worker Isolation** | ❌ | ✅ Isolated cookies/sessions |
-| **Multi-account Login** | ❌ | ✅ |
-| **Parallel Execution** | ❌ | ✅ |
-| **Network Simulation** | ❌ | ✅ 3G/4G/offline |
-| **Workflow Orchestration** | ❌ | ✅ |
-| **Auto Chrome Launch** | ❌ | ✅ |
-
----
-
-## Why It Matters
-
-### The Problem
-
-The official Chrome extension has a fatal flaw: **shared internal state**.
-
-```
-Claude Code 1 ─┐
-               ├─► Chrome Extension (shared state) ─► "Detached" error!
-Claude Code 2 ─┘
-```
-
-When Session A takes a screenshot, Session B's connection breaks. You can only run **one session at a time**.
-
-### The Solution
-
-Claude Chrome Parallel creates **independent CDP connections** per session:
-
-```
-Claude Code 1 ─► CDP Connection 1 ─┐
-                                    ├─► Chrome (port 9222)
-Claude Code 2 ─► CDP Connection 2 ─┘
-
-No shared state = No conflicts = 20+ concurrent sessions
-```
-
-### The Real Power: Authenticated Sessions
-
-Unlike headless automation, this runs in **your actual browser** with all your logins active:
-
-- ✅ Access Gmail, Salesforce, LinkedIn while logged in
-- ✅ No credential management or auth flows needed
-- ✅ Bypass bot detection (real browser profile)
-- ✅ Multiple accounts simultaneously (Worker isolation)
-
-**This isn't just for developers.** Any web task requiring authentication—previously impossible to automate—is now possible with natural language.
-
----
-
-## Quick Start (2 minutes)
-
-### 1. Install
-
-```bash
-npm install -g claude-chrome-parallel
-```
-
-### 2. Configure Claude Code
-
-Add to `~/.claude.json`:
-
-```json
-{
-  "mcpServers": {
-    "chrome-parallel": {
-      "command": "ccp",
-      "args": ["serve"]
-    }
-  }
-}
-```
-
-### 3. Restart Claude Code and use
-
-```
-You: Take a screenshot of https://github.com
-
-Claude: [Auto-launches browser, captures screenshot]
-```
-
-> **Tip:** `ccp` is a shorthand for `claude-chrome-parallel`.
-
----
-
-## Usage Examples
-
-### Multiple Accounts Simultaneously
-
-```
-You: Create "google-personal" and "google-work" Workers,
-     then check the inbox of each Gmail account
-
-Claude: [Creates 2 Workers → Each accesses Gmail with isolated sessions]
-        google-personal: Personal account - 3 new emails
-        google-work: Work account - 7 new emails
-```
-
-### Price Comparison (Parallel)
-
-```
-You: Search for "iPhone 15" lowest price on Amazon, eBay, and Walmart simultaneously
-
-Claude: [3 sites run in parallel]
-        Amazon: $999 (1.2s)
-        eBay: $945 (1.1s)
-        Walmart: $979 (1.3s)
-        Total time: 1.3s (vs 3.6s sequential)
-```
-
-### Parallel QA Testing
-
-```bash
-# Terminal 1
-claude -p "Test myapp.com/login"
-
-# Terminal 2 (at the same time!)
-claude -p "Test myapp.com/checkout"
-
-# Terminal 3 (at the same time!)
-claude -p "Monitor myapp.com/admin"
-```
-
----
-
-## Chrome-Sisyphus: Orchestration Skill
-
-For complex multi-site workflows, use the built-in **Chrome-Sisyphus** skill system.
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│  /chrome-sisyphus "Compare iPhone prices on Amazon, eBay, Walmart"
-│                              ↓
-│  ┌──────────────────────────────────────────────────────────┐
-│  │            ORCHESTRATOR (Main Session)                   │
-│  │  • Decompose task → 3 workers                           │
-│  │  • Allocate sites → Amazon, eBay, Walmart               │
-│  │  • Context usage: ~500 tokens (lightweight!)            │
-│  └──────────────────────────────────────────────────────────┘
-│                              ↓
-│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐
-│  │  Worker 1   │  │  Worker 2   │  │  Worker 3   │
-│  │  (Amazon)   │  │  (eBay)     │  │  (Walmart)  │
-│  │  Background │  │  Background │  │  Background │
-│  │  Task       │  │  Task       │  │  Task       │
-│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘
-│         ↓                ↓                ↓
-│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐
-│  │ Scratchpad  │  │ Scratchpad  │  │ Scratchpad  │
-│  │ worker-1.md │  │ worker-2.md │  │ worker-3.md │
-│  └─────────────┘  └─────────────┘  └─────────────┘
-│                              ↓
-│  Results collected → Unified report to user
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### Why This Matters: Context Isolation
-
-**Without isolation** (traditional approach):
-```
-Main Session Context:
-├── Worker 1 screenshot (500KB)     ─┐
-├── Worker 1 DOM tree (large)        │
-├── Worker 2 screenshot (500KB)      ├─► Context explosion!
-├── Worker 2 DOM tree (large)        │
-└── Worker 3 ... (keeps growing)    ─┘
-```
-
-**With Chrome-Sisyphus**:
-```
-Main Session: ~500 tokens (stays light)
-├── Task plan
-├── Worker IDs
-└── Status summary only
-
-Background Tasks: (isolated, don't pollute main)
-├── Worker 1: own context, own screenshots
-├── Worker 2: own context, own screenshots
-└── Worker 3: own context, own screenshots
-
-Scratchpad Files: (persistent state)
-└── .agent/chrome-sisyphus/*.md
-```
-
-### Usage
-
-Copy the `.claude/` folder to your project:
-
-```bash
-cp -r node_modules/claude-chrome-parallel/.claude ~/.claude/
-# Or copy to your project root
-```
-
-Then use in Claude Code:
-
-```
-/chrome-sisyphus Compare laptop prices on Amazon, BestBuy, and Newegg
-```
-
-### Skill Files
-
-```
-.claude/
-├── commands/
-│   └── chrome-sisyphus.md      # /chrome-sisyphus command
-└── skills/
-    └── chrome-sisyphus/
-        ├── SKILL.md            # Skill overview
-        ├── AGENTS.md           # Agent specifications
-        └── agents/
-            ├── decomposer.md   # Task decomposition
-            ├── worker-agent.md # Worker execution (Ralph Loop)
-            └── coordinator.md  # Result integration
-```
-
----
-
-## MCP Tools
-
-### Browser Automation
-
-| Tool | Description |
-|------|-------------|
-| `navigate` | Go to URL, back/forward |
-| `computer` | Screenshot, click, keyboard, scroll |
-| `read_page` | Parse page structure (accessibility tree) |
-| `find` | Find elements by natural language |
-| `form_input` | Set form values directly |
-| `javascript_tool` | Execute JavaScript |
-| `network` | Simulate network conditions |
-
-### Worker & Tab Management
-
-| Tool | Description |
-|------|-------------|
-| `worker_create` | Create isolated browser context |
-| `worker_list` | List Workers and their tabs |
-| `worker_delete` | Delete Worker |
-| `tabs_create_mcp` | Create new tab |
-| `tabs_context_mcp` | Get tab info |
-
-### Workflow Orchestration
-
-| Tool | Description |
-|------|-------------|
-| `workflow_init` | Initialize parallel workflow |
-| `workflow_status` | Check progress |
-| `workflow_collect` | Collect results |
-| `workflow_cleanup` | Clean up resources |
-
----
-
-## CLI Commands
-
-```bash
-ccp serve              # Start MCP server (auto-run by Claude Code)
-ccp check              # Check Chrome connection
-ccp status             # View session status
-ccp status --json      # JSON output
-ccp doctor             # Diagnose installation
-ccp cleanup            # Clean up old sessions
-ccp serve --port 9223  # Use custom port
-```
-
----
-
-## Performance
-
-| Concurrent Sessions | Success Rate |
-|:---:|:---:|
-| 5 | 100% |
-| 10 | 100% |
-| 15 | 100% |
-| 20 | 100% |
-
----
-
-## Additional Features
-
-### Network Simulation
-
-```
-You: Test myapp.com loading time on 3G network
-
-Claude: [Applies 3G throttling: 1.5Mbps, 100ms latency]
-```
-
-Presets: `offline`, `slow-2g`, `2g`, `3g`, `4g`, `fast-wifi`, `custom`
-
-### Config Recovery
-
-```bash
-# Auto-recover corrupted .claude.json
-ccp recover
-
-# List backups
-ccp recover --list-backups
-```
-
-### Session Isolation
-
-```bash
-# Run Claude with isolated config (prevents race conditions)
-ccp launch
-ccp launch -p "Your prompt"
-```
-
----
-
-## Troubleshooting
-
-### Chrome not connecting
-
-```bash
-ccp check
-# Or manually start Chrome
-chrome --remote-debugging-port=9222
-```
-
-### Tools not appearing in Claude Code
-
-1. Check `~/.claude.json` configuration
-2. Restart Claude Code
-3. Run `/mcp` to verify `chrome-parallel` is listed
-
----
-
-## Use Cases
-
-- **Business**: ERP/SaaS data extraction, invoice downloads, repetitive task automation
-- **Research**: Login-required platform data collection, academic DB searches
-- **Social Media**: Multi-account posting, message management, analytics
-- **E-commerce**: Member price monitoring, inventory management, review responses
-- **QA Testing**: Parallel scenario testing, network condition testing
-- **Productivity**: Email organization, calendar management, bookmark management
-
----
-
-## Development
-
-```bash
-git clone https://github.com/shaun0927/claude-chrome-parallel.git
-cd claude-chrome-parallel
-npm install
-npm run build
-npm test
-```
-
----
-
-## License
-
-MIT License - [LICENSE](LICENSE)
-
----
-
-## Disclaimer
-
-> **This is an unofficial community project.**
-> Not affiliated with Anthropic.
->
-> "Claude" is a trademark of Anthropic.
-
-## Acknowledgments
-
-- [Anthropic](https://anthropic.com) - Claude and MCP protocol
-- [Puppeteer](https://pptr.dev/) - Browser automation
+# Claude Chrome Parallel
+
+> **Ultrafast parallel browser MCP.**
+
+[![GitHub release](https://img.shields.io/github/v/release/shaun0927/claude-chrome-parallel)](https://github.com/shaun0927/claude-chrome-parallel/releases)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Automate your **actual Chrome** — with all your logins, cookies, and sessions intact. Run **20+ parallel browser sessions** from Claude Code without logging in to anything, ever again.
+
+```
+"Screenshot my AWS, Stripe, Vercel, GitHub, and Slack dashboards"
+
+Playwright MCP (sequential, login each site):
+  AWS    🔐━━━━━━━━━━━━━━ login 45s ━━━━ task
+  Stripe              🔐━━━━━━━━━━━━━━ login 40s ━━━━ task
+  Vercel                           🔐━━━━━━━━━━━━━━ login 50s ━━━━ task
+  GitHub                                        🔐━━━━━━━━━━━━ login 35s ━━━━ task
+  Slack                                                      🔐━━━━━━━━━━━━ login 40s ━━━━ task
+  Total: ~250s | Memory: ~2.5 GB (5 browser instances)
+
+CCP (parallel, zero auth):
+  AWS    ━━━━ 3s ✓
+  Stripe ━━━━ 3s ✓
+  Vercel ━━━━ 3s ✓
+  GitHub ━━━━ 3s ✓
+  Slack  ━━━━ 3s ✓
+  Total: ~3s  | Memory: ~300 MB (1 Chrome, shared contexts)
+
+  80x faster. 8x less memory. Zero logins.
+```
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/shaun0927/claude-chrome-parallel/main/assets/demo.svg" alt="Playwright MCP vs CCP — 5 authenticated sites comparison" width="100%">
+</p>
+
+---
+
+## Why CCP Is Fast
+
+The speed advantage **compounds** with every site. Playwright MCP has two bottlenecks that multiply:
+
+| Sites | Playwright MCP | CCP | Speedup |
+|:-----:|:--------------:|:---:|:-------:|
+| 1 | ~50s (login + task) | ~3s | **17x** |
+| 3 | ~155s (sequential) | ~3s (parallel) | **50x** |
+| 5 | ~250s | ~3s | **80x** |
+| 10 | ~500s | ~3s | **160x** |
+
+**Why?** Playwright launches a blank browser per site. Each needs: navigate → type email → type password → solve 2FA → wait for redirect. That's 30-120s **per site**, and it's **sequential**.
+
+CCP connects to your existing Chrome. You're already logged into everything. Workers run in parallel. The task that takes 250s with Playwright takes 3s with CCP.
+
+### Memory
+
+Playwright spawns a **separate browser process** per session (~500MB each). Five sites = 2.5GB.
+
+CCP uses **one Chrome** with lightweight browser contexts (like incognito windows sharing the same process). Five Workers = ~300MB total. That's **8x less memory** — and it stays flat whether you run 5 or 20 Workers.
+
+---
+
+## Core Features
+
+<table>
+<tr>
+<td width="25%" valign="top">
+
+### Zero Auth
+
+Your actual Chrome profile. Gmail, Slack, AWS, Stripe — **already logged in**.
+
+No credentials. No OAuth. No 2FA loops.
+
+</td>
+<td width="25%" valign="top">
+
+### 20+ Parallel Workers
+
+All Workers run simultaneously in isolated browser contexts.
+
+5 sites in ~3s, not ~250s.
+
+</td>
+<td width="25%" valign="top">
+
+### 8x Less Memory
+
+One Chrome process, shared contexts. Not N separate browser instances.
+
+5 Workers ≈ 300MB, not 2.5GB.
+
+</td>
+<td width="25%" valign="top">
+
+### Worker Isolation
+
+Each Worker gets separate cookies, localStorage, and sessions.
+
+**5 accounts on the same site. Simultaneously.**
+
+</td>
+</tr>
+</table>
+
+---
+
+## Quick Start
+
+```bash
+# One command. That's it.
+npx claude-chrome-parallel setup
+
+# Restart Claude Code — just say "ccp".
+```
+
+**Updates are automatic.** The MCP server runs via `npx`, so you always get the latest version.
+
+<details>
+<summary>Manual setup</summary>
+
+```json
+{
+  "mcpServers": {
+    "chrome-parallel": {
+      "command": "npx",
+      "args": ["-y", "claude-chrome-parallel", "serve", "--auto-launch"]
+    }
+  }
+}
+```
+
+Or: `claude mcp add claude-chrome-parallel -- npx -y claude-chrome-parallel serve --auto-launch`
+
+</details>
+
+<details>
+<summary>Installation scope</summary>
+
+```bash
+npx claude-chrome-parallel setup                  # Global — all projects (default)
+npx claude-chrome-parallel setup --scope project  # Project — this directory only
+```
+
+Global writes to `~/.claude.json`. Project writes to `.mcp.json` in the current directory.
+
+</details>
+
+---
+
+## Just Say `ccp`
+
+After setup, **`ccp` is your magic word.** No flags, no config, no boilerplate. Just tell Claude what you want with "ccp" and it happens.
+
+```
+You: ccp screenshot my Gmail inbox
+Claude: [Already logged in. Screenshot taken. Done.]
+
+You: ccp check my AWS billing and Stripe revenue at the same time
+Claude: [2 Workers, parallel, 2.1s — both dashboards captured]
+
+You: use ccp to compare iPhone prices on Amazon, eBay, and Walmart
+Claude: [3 Workers, 3 sites, simultaneously]
+        Amazon:  $999 | eBay: $945 ← lowest | Walmart: $979
+```
+
+**How it works**: CCP uses the MCP protocol's native `instructions` field to teach Claude the keyword automatically. No CLAUDE.md injection. No hooks. Just install and go.
+
+---
+
+## What You Can Do
+
+### Multi-Account Operations
+
+```
+You: ccp check my personal and work Gmail at the same time
+
+Claude: [Creates 2 isolated Workers]
+        Personal account: 3 unread emails
+        Work account: 7 unread emails
+        Time: 2.1s (parallel)
+```
+
+### Price Comparison Across Sites
+
+```
+You: ccp find the cheapest iPhone 15 on Amazon, eBay, and Walmart
+
+Claude: [3 Workers, 3 sites, simultaneously]
+        Amazon:  $999
+        eBay:    $945  ← lowest
+        Walmart: $979
+        Time: 1.3s total (not 3.9s)
+```
+
+### Authenticated Dashboard Monitoring
+
+```
+You: ccp screenshot my AWS billing, Stripe dashboard, and Vercel usage
+
+Claude: [All 3 require login — but you're already authenticated]
+        aws-billing.png    ✓
+        stripe-revenue.png ✓
+        vercel-usage.png   ✓
+```
+
+### Parallel QA Testing
+
+```bash
+# 5 tests, 5 terminals, all at once
+claude -p "ccp test login flow on myapp.com"       # Worker 1
+claude -p "ccp test checkout on myapp.com"          # Worker 2
+claude -p "ccp test admin panel on myapp.com"       # Worker 3
+claude -p "ccp test mobile view on myapp.com"       # Worker 4
+claude -p "ccp test form validation on myapp.com"   # Worker 5
+
+# Sequential: ~5 minutes.  Parallel with CCP: ~1 minute.
+# That's your entire smoke test suite before lunch.
+```
+
+---
+
+## Comparison
+
+| | Playwright MCP | Browserbase | Chrome Extension | **CCP** |
+|---|:---:|:---:|:---:|:---:|
+| **Auth overhead per site** | ❌ 30-120s | ❌ 30-120s | ✅ 0s | **✅ 0s** |
+| **5-site authenticated task** | ~250s | ~250s + cost | N/A (1 session) | **~3s** |
+| **Memory (5 sessions)** | ~2.5 GB | N/A (cloud) | N/A | **~300 MB** |
+| **Uses your Chrome logins** | ❌ Blank browser | ❌ Cloud browser | ✅ | **✅** |
+| **Concurrent sessions** | ⚠️ Limited | ✅ (paid) | ❌ 1 (crashes) | **✅ 20+** |
+| **Multi-account isolation** | ❌ | ✅ (paid) | ❌ | **✅** |
+| **Runs locally** | ✅ | ❌ Cloud only | ✅ | **✅** |
+| **Free** | ✅ | ❌ | ✅ | **✅** |
+| **No bot detection** | ❌ Headless | ❌ Fingerprinted | ✅ | **✅** |
+| **Device emulation** | ✅ | ✅ | ❌ | **✅** |
+| **Network simulation** | ✅ | ❌ | ❌ | **✅** |
+| **Workflow orchestration** | ❌ | ❌ | ❌ | **✅** |
+| **Adaptive Guidance** | ❌ | ❌ | ❌ | **✅** |
+
+---
+
+## Adaptive Guidance
+
+Every tool response includes contextual hints that prevent the LLM from wasting time on wrong approaches. 21 static rules + an adaptive memory system that learns from your usage patterns.
+
+```
+click_element → Error: "ref not found"
+  _hint: "Refs expire after page changes. Use read_page for fresh refs."
+  → LLM self-corrects. No retry loop. No wasted tokens.
+
+navigate → title contains "Login"
+  _hint: "Login page detected. Use fill_form for credentials."
+  → LLM skips straight to form filling.
+```
+
+**Adaptive Memory**: The system observes which tool resolves each error type. After seeing the same recovery pattern 3 times, it promotes it to a permanent hint — persisted across sessions in `.chrome-parallel/hints/learned-patterns.json`.
+
+<details>
+<summary>Rule priority tiers</summary>
+
+| Tier | Priority | Examples |
+|------|----------|---------|
+| Error Recovery | 100 | Stale refs, tab not found, timeouts, null elements |
+| Composite Hints | 200 | find+click → click_element, multiple form_input → fill_form |
+| Repetition Detection | 250 | Same-tool error streaks, A↔B oscillation loops |
+| Sequence Detection | 300 | Login page detection, navigate→screenshot without wait |
+| Learned Patterns | 350 | Automatically discovered error→recovery correlations |
+| Success Hints | 400 | Post-click navigation check, form submission verification |
+
+</details>
+
+---
+
+## Tools (36)
+
+<details>
+<summary><b>Browser Automation</b> — navigate, click, type, find</summary>
+
+| Tool | Description |
+|------|-------------|
+| `navigate` | Go to URL, back/forward |
+| `computer` | Screenshot, click, keyboard, scroll |
+| `read_page` | Parse page structure (accessibility tree) |
+| `find` | Find elements by natural language |
+| `click_element` | Find and click in one step |
+| `wait_and_click` | Wait for element, then click |
+| `form_input` | Set individual form values |
+| `fill_form` | Fill multiple fields + submit in one call |
+| `javascript_tool` | Execute JavaScript |
+
+</details>
+
+<details>
+<summary><b>Browser Environment</b> — device, network, location</summary>
+
+| Tool | Description |
+|------|-------------|
+| `user_agent` | Set User-Agent (chrome, safari, googlebot, etc.) |
+| `geolocation` | Override location (seoul, tokyo, new-york, etc.) |
+| `emulate_device` | Device emulation (iphone-14, ipad-pro, pixel-7, etc.) |
+| `network` | Simulate network conditions (3G, 4G, offline) |
+
+</details>
+
+<details>
+<summary><b>Page Operations</b> — content, PDF, reload, wait</summary>
+
+| Tool | Description |
+|------|-------------|
+| `page_reload` | Reload page (optional cache bypass) |
+| `page_content` | Get HTML content from page or element |
+| `page_pdf` | Generate PDF (A4, Letter, landscape) |
+| `wait_for` | Wait for selector, navigation, function, or timeout |
+
+</details>
+
+<details>
+<summary><b>DOM, Storage, Debugging, Advanced</b></summary>
+
+| Tool | Description |
+|------|-------------|
+| `selector_query` | Query elements by CSS selector |
+| `xpath_query` | Query elements by XPath expression |
+| `cookies` | Get/set/delete browser cookies |
+| `storage` | Manage localStorage/sessionStorage |
+| `console_capture` | Capture console logs (with type filtering) |
+| `performance_metrics` | Performance metrics (FCP, load time, JS heap) |
+| `request_intercept` | Intercept/block/log network requests |
+| `drag_drop` | Drag and drop by selector or coordinates |
+| `file_upload` | Upload files to file input elements |
+| `http_auth` | Set HTTP Basic Authentication credentials |
+
+</details>
+
+<details>
+<summary><b>Workers & Orchestration</b></summary>
+
+| Tool | Description |
+|------|-------------|
+| `worker_create` | Create isolated browser context |
+| `worker_list` | List Workers and their tabs |
+| `worker_update` | Update worker progress |
+| `worker_complete` | Mark worker as complete |
+| `worker_delete` | Delete Worker |
+| `tabs_create_mcp` | Create new tab |
+| `tabs_context_mcp` | Get tab info |
+| `tabs_close` | Close tabs |
+| `workflow_init` | Initialize parallel workflow |
+| `workflow_status` | Check workflow progress |
+| `workflow_collect` | Collect results from all Workers |
+| `workflow_cleanup` | Clean up workflow resources |
+
+</details>
+
+---
+
+## CLI
+
+```bash
+npx claude-chrome-parallel setup                  # Auto-configure (global)
+npx claude-chrome-parallel setup --scope project  # Auto-configure (project only)
+npx claude-chrome-parallel serve --auto-launch    # Start with auto Chrome launch
+npx claude-chrome-parallel serve --headless-shell # Headless mode (15-30% less memory)
+npx claude-chrome-parallel serve -p <port>        # Custom debugging port (default: 9222)
+npx claude-chrome-parallel doctor                 # Diagnose installation
+npx claude-chrome-parallel status                 # View sessions
+npx claude-chrome-parallel cleanup                # Clean up old sessions
+```
+
+---
+
+<details>
+<summary><b>Performance Optimizations</b></summary>
+
+- **Memory** — Renderer process limits, JS heap caps, forced GC on tab close
+- **Screenshots** — WebP format (3-5x smaller than PNG)
+- **Cookie Bridge** — 30s TTL cache for auth cookie sharing (~10ms vs 2-6s)
+- **Find Tool** — Batched CDP queries (~100ms vs ~400ms)
+- **Headless Shell** — `--headless-shell` for 15-30% less memory
+
+</details>
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/shaun0927/claude-chrome-parallel.git
+cd claude-chrome-parallel
+npm install && npm run build && npm test
+```
+
+## License
+
+MIT — [LICENSE](LICENSE)
+
+---
+
+> **Disclaimer**: Unofficial community project. Not affiliated with Anthropic. "Claude" is a trademark of Anthropic.