High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.
chore: clean up
Luigi Agosti245c74f7e97a
diff --git a/.github/DOCUMENTATION_REVIEW.md b/.github/DOCUMENTATION_REVIEW.mdindex 6ae253de..8f7b7434 100644--- a/.github/DOCUMENTATION_REVIEW.md+++ b/.github/DOCUMENTATION_REVIEW.md@@ -255,11 +255,11 @@ When given the task "Review documentation", verify:❌ **Outdated examples:**```bash# OLD (deprecated)-pinchtab nav https://example.com # ← This command was removed+pinchtab nav https://pinchtab.com # ← This command was removed# NEW (correct)curl -X POST http://localhost:9867/navigate \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'```❌ **Wrong API format:**diff --git a/README.md b/README.mdindex 3f917907..fb7da2b0 100644--- a/README.md+++ b/README.md@@ -70,7 +70,7 @@ pinchtab**Terminal 2 — Control the browser:**```bash# Navigate-pinchtab nav https://example.com+pinchtab nav https://pinchtab.com# Get page structurepinchtab snap -i -c@@ -148,10 +148,10 @@ An **SMCP plugin** in this repo lets AI agents control PinchTab via the [Model C```bash# Your AI agent can:-pinchtab nav https://example.com+pinchtab nav https://pinchtab.compinchtab snap -i # Get clickable elementspinchtab click e5 # Click by ref-pinchtab fill e3 "[email protected]" # Fill input+pinchtab fill e3 "[email protected]" # Fill inputpinchtab press e7 Enter # Submit form```@@ -159,7 +159,7 @@ pinchtab press e7 Enter # Submit form```bash# Extract text (token-efficient)-pinchtab nav https://example.com/article+pinchtab nav https://pinchtab.com/articlepinchtab text # ~800 tokens instead of 10,000```diff --git a/cmd/pinchtab/cmd_cli.go b/cmd/pinchtab/cmd_cli.goindex 4dbc0e17..5aa7d381 100644--- a/cmd/pinchtab/cmd_cli.go+++ b/cmd/pinchtab/cmd_cli.go@@ -83,7 +83,7 @@ ENVIRONMENT:BRIDGE_HEADLESS Run Chrome headless (default: true)Examples:- pinchtab nav https://example.com+ pinchtab nav https://pinchtab.compinchtab snap -i -cpinchtab click e5pinchtab type e12 hello world@@ -176,7 +176,7 @@ QUICK START:WORKFLOW:1. Start server: pinchtab (runs on :9867)- 2. Navigate: pinchtab nav https://example.com+ 2. Navigate: pinchtab nav https://pinchtab.com3. See page: pinchtab snap (shows clickable refs)4. Interact: pinchtab click e5 (click element)5. Check result: pinchtab snap (see changes)diff --git a/cmd/pinchtab/cmd_cli_test.go b/cmd/pinchtab/cmd_cli_test.goindex e6356838..d5e06339 100644--- a/cmd/pinchtab/cmd_cli_test.go+++ b/cmd/pinchtab/cmd_cli_test.go@@ -73,7 +73,7 @@ func TestCLINavigate(t *testing.T) {defer m.close()client := m.server.Client()- cliNavigate(client, m.base(), "", []string{"https://example.com"})+ cliNavigate(client, m.base(), "", []string{"https://pinchtab.com"})if m.lastMethod != "POST" {t.Errorf("expected POST, got %s", m.lastMethod)}@@ -82,8 +82,8 @@ func TestCLINavigate(t *testing.T) {}var body map[string]any_ = json.Unmarshal([]byte(m.lastBody), &body)- if body["url"] != "https://example.com" {- t.Errorf("expected url=https://example.com, got %v", body["url"])+ if body["url"] != "https://pinchtab.com" {+ t.Errorf("expected url=https://pinchtab.com, got %v", body["url"])}}@@ -92,7 +92,7 @@ func TestCLINavigateWithFlags(t *testing.T) {defer m.close()client := m.server.Client()- cliNavigate(client, m.base(), "", []string{"https://example.com", "--new-tab", "--block-images"})+ cliNavigate(client, m.base(), "", []string{"https://pinchtab.com", "--new-tab", "--block-images"})var body map[string]any_ = json.Unmarshal([]byte(m.lastBody), &body)if body["newTab"] != true {@@ -108,7 +108,7 @@ func TestCLINavigateWithBlockAds(t *testing.T) {defer m.close()client := m.server.Client()- cliNavigate(client, m.base(), "", []string{"https://example.com", "--block-ads"})+ cliNavigate(client, m.base(), "", []string{"https://pinchtab.com", "--block-ads"})var body map[string]any_ = json.Unmarshal([]byte(m.lastBody), &body)if body["blockAds"] != true {@@ -122,7 +122,7 @@ func TestCLIInstanceNavigateUsesTabRoute(t *testing.T) {defer m.close()client := m.server.Client()- cliInstanceNavigate(client, m.base(), "", []string{"inst-123", "https://example.com"})+ cliInstanceNavigate(client, m.base(), "", []string{"inst-123", "https://pinchtab.com"})if m.lastMethod != "POST" {t.Errorf("expected POST, got %s", m.lastMethod)@@ -133,7 +133,7 @@ func TestCLIInstanceNavigateUsesTabRoute(t *testing.T) {var body map[string]any_ = json.Unmarshal([]byte(m.lastBody), &body)- if body["url"] != "https://example.com" {+ if body["url"] != "https://pinchtab.com" {t.Errorf("expected navigate URL in body, got %v", body["url"])}}@@ -323,7 +323,7 @@ func TestCLISelect(t *testing.T) {func TestCLIText(t *testing.T) {m := newMockServer()- m.response = `{"url":"https://example.com","title":"Example","text":"Hello"}`+ m.response = `{"url":"https://pinchtab.com","title":"Example","text":"Hello"}`defer m.close()client := m.server.Client()@@ -359,7 +359,7 @@ func TestCLITextTab(t *testing.T) {func TestCLITabsList(t *testing.T) {m := newMockServer()- m.response = `[{"id":"TAB1","url":"https://example.com"}]`+ m.response = `[{"id":"TAB1","url":"https://pinchtab.com"}]`defer m.close()client := m.server.Client()@@ -374,7 +374,7 @@ func TestCLITabsNew(t *testing.T) {defer m.close()client := m.server.Client()- cliTabs(client, m.base(), "", []string{"new", "https://example.com"})+ cliTabs(client, m.base(), "", []string{"new", "https://pinchtab.com"})if m.lastPath != "/tab" {t.Errorf("expected /tab, got %s", m.lastPath)}@@ -383,7 +383,7 @@ func TestCLITabsNew(t *testing.T) {if body["action"] != "new" {t.Errorf("expected action=new, got %v", body["action"])}- if body["url"] != "https://example.com" {+ if body["url"] != "https://pinchtab.com" {t.Errorf("expected url, got %v", body["url"])}}diff --git a/dashboard/src/components/molecules/ProfileCard.test.tsx b/dashboard/src/components/molecules/ProfileCard.test.tsxindex 9c8575ea..2b03482d 100644--- a/dashboard/src/components/molecules/ProfileCard.test.tsx+++ b/dashboard/src/components/molecules/ProfileCard.test.tsx@@ -88,10 +88,10 @@ describe("ProfileCard", () => {it("displays account email", () => {const profileWithEmail = {...mockProfile,- accountEmail: "[email protected]",+ accountEmail: "[email protected]",};render(<ProfileCard profile={profileWithEmail} onLaunch={() => {}} />);- expect(screen.getByText("[email protected]")).toBeInTheDocument();+ expect(screen.getByText("[email protected]")).toBeInTheDocument();});it("displays account name when no email", () => {diff --git a/dashboard/src/components/molecules/TabItem.test.tsx b/dashboard/src/components/molecules/TabItem.test.tsxindex 440890b4..93185bb6 100644--- a/dashboard/src/components/molecules/TabItem.test.tsx+++ b/dashboard/src/components/molecules/TabItem.test.tsx@@ -6,7 +6,7 @@ import type { InstanceTab } from "../../generated/types";const mockTab: InstanceTab = {id: "tab_123",instanceId: "inst_456",- url: "https://example.com/page",+ url: "https://pinchtab.com/page",title: "Example Page",};@@ -15,7 +15,7 @@ describe("TabItem", () => {render(<TabItem tab={mockTab} />);expect(screen.getByText("Example Page")).toBeInTheDocument();- expect(screen.getByText("https://example.com/page")).toBeInTheDocument();+ expect(screen.getByText("https://pinchtab.com/page")).toBeInTheDocument();});it("shows Untitled for tabs without title", () => {diff --git a/dashboard/src/stores/useAppStore.test.ts b/dashboard/src/stores/useAppStore.test.tsindex 7e6fc2a1..2a535620 100644--- a/dashboard/src/stores/useAppStore.test.ts+++ b/dashboard/src/stores/useAppStore.test.ts@@ -63,7 +63,7 @@ describe("useAppStore", () => {it("sets current tabs", () => {const tabs = {- inst_123: [{ id: "tab_1", url: "https://example.com" }],+ inst_123: [{ id: "tab_1", url: "https://pinchtab.com" }],} as any;useAppStore.getState().setCurrentTabs(tabs);expect(useAppStore.getState().currentTabs).toEqual(tabs);diff --git a/docs/core-concepts.md b/docs/core-concepts.mdindex e36f9ee5..f5401ad9 100644--- a/docs/core-concepts.md+++ b/docs/core-concepts.md@@ -157,12 +157,12 @@ pinchtab instance launch # Uses temp auto-generated profile**Separate User Accounts:**```textInstance 1 (profile: alice)- ├── Tab 1: [email protected] logged in- └── Tab 2: [email protected] dashboard+ ├── Tab 1: [email protected] logged in+ └── Tab 2: [email protected] dashboardInstance 2 (profile: bob)- ├── Tab 1: [email protected] logged in- └── Tab 2: [email protected] dashboard+ ├── Tab 1: [email protected] logged in+ └── Tab 2: [email protected] dashboard``````bash@@ -188,7 +188,7 @@ curl -X POST http://localhost:9867/instances/start \# Navigate and log incurl -X POST http://localhost:9867/instances/inst_xyz/navigate \- -d '{"url": "https://example.com/login"}'+ -d '{"url": "https://pinchtab.com/login"}'# ... fill login form, click submit ...# Later (even after instance restart): Profile is persistent@@ -213,11 +213,11 @@ A **browser tab** (webpage) within an instance and its profile.# Create tab in instance (returns tabId)curl -X POST http://localhost:9867/instances/inst_0a89a5bb/tabs/open \-H "Content-Type: application/json" \- -d '{"url": "https://example.com"}' | jq '.tabId'+ -d '{"url": "https://pinchtab"}' | jq '.tabId'# Returns: "tab_abc123"# Or via CLI-pinchtab tab open inst_0a89a5bb https://example.com+pinchtab tab open inst_0a89a5bb https://pinchtab.com# Get tab infocurl http://localhost:9867/tabs/tab_abc123 | jq .@@ -250,7 +250,7 @@ pinchtab tab close tab_abc123PinchTab Orchestrator (HTTP server on port 9867)│├── Instance 1 (inst_0a89a5bb, port 9868, temp profile)- │ ├── Tab 1 (tab_xyz123, https://example.com)+ │ ├── Tab 1 (tab_xyz123, https://pinchtab.com)│ ├── Tab 2 (tab_xyz124, https://google.com)│ └── Tab 3 (tab_xyz125, https://github.com)│@@ -259,7 +259,7 @@ PinchTab Orchestrator (HTTP server on port 9867)│ └── Tab 2 (tab_abc002, internal docs)│└── Instance 3 (inst_2c8a5eef, port 9870, profile: personal)- ├── Tab 1 (tab_def001, gmail, logged in as [email protected])+ ├── Tab 1 (tab_def001, gmail, logged in as [email protected])└── Tab 2 (tab_def002, bank.com)```@@ -291,7 +291,7 @@ INST=$(pinchtab instance launch --mode headless)# Create multiple tabs in the same instancecurl -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'curl -X POST http://localhost:9867/instances/$INST/tabs/open \-d '{"url":"https://google.com"}'@@ -324,10 +324,10 @@ INST_BOB=$(curl -X POST http://localhost:9867/instances/start \# Create tabs in both instances with isolated cookiescurl -X POST http://localhost:9867/instances/$INST_ALICE/tabs/open \- -d '{"url":"https://app.example.com"}'+ -d '{"url":"https://app.pinchtab.com"}'curl -X POST http://localhost:9867/instances/$INST_BOB/tabs/open \- -d '{"url":"https://app.example.com"}'+ -d '{"url":"https://app.pinchtab.com"}'# Login in each instance separately — profiles keep sessions isolated```@@ -340,7 +340,7 @@ INST=$(pinchtab instance launch)# Create tab, use itcurl -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'# ... work ...# Stop instance@@ -368,7 +368,7 @@ done# Now safe to make requests to the instancecurl -X POST http://localhost:9867/instances/$INST/navigate \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'```---diff --git a/docs/get-started.md b/docs/get-started.mdindex 2f473ce6..2bc99cf3 100644--- a/docs/get-started.md+++ b/docs/get-started.md@@ -92,7 +92,7 @@ sleep 3```bash# Navigate to a website-pinchtab instance navigate $INST https://example.com+pinchtab instance navigate $INST https://pinchtab.com# Get page structurecurl http://localhost:9867/tabs/$TAB_ID/snapshot | jq '.nodes | map({role, name}) | .[0:5]'@@ -115,7 +115,7 @@ sleep 2# NavigateTAB_ID=$(curl -s -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://example.com"}' | jq -r '.id')+ -d '{"url":"https://pinchtab.com"}' | jq -r '.id')# Read the page as textcurl http://localhost:9867/tabs/$TAB_ID/text@@ -155,7 +155,7 @@ curl -X POST http://localhost:9867/tabs/$TAB_ID/action \# Or fill a form inputcurl -X POST http://localhost:9867/tabs/$TAB_ID/action \-H "Content-Type: application/json" \- -d '{"kind":"fill","ref":"e3","text":"[email protected]"}'+ -d '{"kind":"fill","ref":"e3","text":"[email protected]"}'```### Multiple Tabs@@ -207,7 +207,7 @@ sleep 2# 2. Navigate to a pageTAB_ID=$(curl -s -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://example.com"}' | jq -r '.id')+ -d '{"url":"https://pinchtab.com"}' | jq -r '.id')# 3. Get page structure (see buttons, links, inputs)curl http://localhost:9867/tabs/$TAB_ID/snapshot@@ -244,7 +244,7 @@ sleep 2# Navigatecurl -X POST http://localhost:9867/instances/$INST/tabs/open \-H "Content-Type: application/json" \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'# Get snapshotcurl http://localhost:9867/tabs/$TAB_ID/snapshot@@ -280,7 +280,7 @@ time.sleep(2)# 2. Create tab by navigatingresp = requests.post(f"{BASE}/instances/{inst_id}/tabs/open", json={- "url": "https://example.com"+ "url": "https://pinchtab.com"})tab_id = resp.json()["id"]print(f"Navigated: {resp.json()}")@@ -337,7 +337,7 @@ async function main() {method: "POST",headers: { "Content-Type": "application/json" },body: JSON.stringify({- url: "https://example.com"+ url: "https://pinchtab.com"})});const navData = await navResp.json();@@ -437,7 +437,7 @@ sleep 2# Navigatecurl -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://example.com/article"}'+ -d '{"url":"https://pinchtab.com/article"}'# Extract textcurl http://localhost:9867/tabs/$TAB_ID/text | jq '.text'@@ -458,7 +458,7 @@ sleep 2# Navigate to formcurl -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://example.com/contact"}'+ -d '{"url":"https://pinchtab.com/contact"}'# Get form structureSNAP=$(curl http://localhost:9867/tabs/$TAB_ID/snapshot)@@ -468,7 +468,7 @@ curl -X POST http://localhost:9867/tabs/$TAB_ID/action \-d '{"kind":"fill","ref":"e3","text":"John Doe"}'curl -X POST http://localhost:9867/tabs/$TAB_ID/action \- -d '{"kind":"fill","ref":"e5","text":"[email protected]"}'+ -d '{"kind":"fill","ref":"e5","text":"[email protected]"}'curl -X POST http://localhost:9867/tabs/$TAB_ID/action \-d '{"kind":"fill","ref":"e7","text":"My message here"}'@@ -495,10 +495,10 @@ sleep 2# Logincurl -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://example.com/login"}'+ -d '{"url":"https://pinchtab.com/login"}'curl -X POST http://localhost:9867/tabs/$TAB_ID/action \- -d '{"kind":"fill","ref":"e3","text":"[email protected]"}'+ -d '{"kind":"fill","ref":"e3","text":"[email protected]"}'curl -X POST http://localhost:9867/tabs/$TAB_ID/action \-d '{"kind":"fill","ref":"e5","text":"password"}'@@ -516,7 +516,7 @@ sleep 2# Navigate to dashboard (cookies preserved)curl -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://example.com/dashboard"}'+ -d '{"url":"https://pinchtab.com/dashboard"}'```### Scenario 4: Generate PDF Report@@ -527,7 +527,7 @@ INST=$(pinchtab instance launch | jq -r '.id')sleep 2TAB_ID=$(curl -s -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://reports.example.com/monthly"}' | jq -r '.id')+ -d '{"url":"https://reports.pinchtab.com/monthly"}' | jq -r '.id')# Export PDFcurl "http://localhost:9867/tabs/$TAB_ID/pdf?landscape=true" -o report.pdf```@@ -541,11 +541,11 @@ sleep 2# Open first tab (source)curl -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://source.example.com"}'+ -d '{"url":"https://source.pinchtab.com"}'# Open second tab (destination)curl -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://destination.example.com"}'+ -d '{"url":"https://destination.pinchtab.com"}'# List tabsTABS=$(curl http://localhost:9867/instances/$INST/tabs)@@ -594,7 +594,7 @@ done# Now safe to usecurl -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'```### "Port already in use"diff --git a/docs/guides/agent-optimization.md b/docs/guides/agent-optimization.mdindex 34c72a5e..40d26a50 100644--- a/docs/guides/agent-optimization.md+++ b/docs/guides/agent-optimization.md@@ -51,7 +51,7 @@ After sleeping 3 seconds:```bashcurl -X POST http://localhost:9867/navigate \-H "Content-Type: application/json" \- -d '{"url": "https://example.com"}' && \+ -d '{"url": "https://pinchtab.com"}' && \sleep 3 && \curl http://localhost:9867/snapshot | \jq '.nodes[] | select(.name | length > 15) | .name' | \diff --git a/docs/guides/cdp-url-shared-chrome.md b/docs/guides/cdp-url-shared-chrome.mdindex a0a4ccb7..5034af60 100644--- a/docs/guides/cdp-url-shared-chrome.md+++ b/docs/guides/cdp-url-shared-chrome.md@@ -239,7 +239,7 @@ ssh -L 9222:remote-chrome:9222 user@remote-host &export CDP_URL="ws://localhost:9222/..."# Or direct (less secure)-export CDP_URL="ws://remote-chrome.example.com:9222/..."+export CDP_URL="ws://remote-chrome.pinchtab.com:9222/..."```## Configuration Referencediff --git a/docs/guides/common-patterns.md b/docs/guides/common-patterns.mdindex ca1fbbaf..7462bc3d 100644--- a/docs/guides/common-patterns.md+++ b/docs/guides/common-patterns.md@@ -49,7 +49,7 @@ sleep 2# Optionally navigate to starting URL (via orchestrator proxy)curl -s -X POST "http://localhost:9867/instances/$INST/tabs/open" \-H "Content-Type: application/json" \- -d '{"url":"https://app.example.com"}'+ -d '{"url":"https://app.pinchtab.com"}'echo "Navigate the app manually, then run automated tests..."sleep 300@@ -102,11 +102,11 @@ echo "Created 5 parallel test workers"# Run tests in parallelTEST_URLS=(- "https://app.example.com/test1"- "https://app.example.com/test2"- "https://app.example.com/test3"- "https://app.example.com/test4"- "https://app.example.com/test5"+ "https://app.pinchtab.com/test1"+ "https://app.pinchtab.com/test2"+ "https://app.pinchtab.com/test3"+ "https://app.pinchtab.com/test4"+ "https://app.pinchtab.com/test5")for i in "${!INSTANCES[@]}"; do@@ -180,14 +180,14 @@ donesleep 3URLS=(- "https://example.com/page1"- "https://example.com/page2"- "https://example.com/page3"- "https://example.com/page4"- "https://example.com/page5"- "https://example.com/page6"- "https://example.com/page7"- "https://example.com/page8"+ "https://pinchtab.com/page1"+ "https://pinchtab.com/page2"+ "https://pinchtab.com/page3"+ "https://pinchtab.com/page4"+ "https://pinchtab.com/page5"+ "https://pinchtab.com/page6"+ "https://pinchtab.com/page7"+ "https://pinchtab.com/page8")# Distribute evenly via orchestrator proxy@@ -272,11 +272,11 @@ done# Work queue (100 URLs)QUEUE=(- "https://example.com/1"- "https://example.com/2"- "https://example.com/3"+ "https://pinchtab.com/1"+ "https://pinchtab.com/2"+ "https://pinchtab.com/3"# ... up to ...- "https://example.com/100"+ "https://pinchtab.com/100")# Process queue with max concurrent jobs (use 'wait -n' for job-level control)@@ -368,19 +368,19 @@ U3=$(curl -s -X POST http://localhost:9867/instances/start \# User 1 navigates (via orchestrator proxy)curl -s -X POST "http://localhost:9867/instances/$U1/tabs/open" \-H "Content-Type: application/json" \- -d '{"url":"https://app.example.com/login?user=1"}'+ -d '{"url":"https://app.pinchtab.com/login?user=1"}'# User 2 navigates independentlyPORT_U2=$(curl -s http://localhost:9867/instances/$U2 | jq -r '.port')curl -s -X POST "http://localhost:$PORT_U2/navigate" \-H "Content-Type: application/json" \- -d '{"url":"https://app.example.com/login?user=2"}'+ -d '{"url":"https://app.pinchtab.com/login?user=2"}'# User 3 navigates independentlyPORT_U3=$(curl -s http://localhost:9867/instances/$U3 | jq -r '.port')curl -s -X POST "http://localhost:$PORT_U3/navigate" \-H "Content-Type: application/json" \- -d '{"url":"https://app.example.com/login?user=3"}'+ -d '{"url":"https://app.pinchtab.com/login?user=3"}'```### Session Persistence@@ -400,7 +400,7 @@ PORT=$(curl -s http://localhost:9867/instances/$INST | jq -r '.port')# Navigate and set up statecurl -s -X POST "http://localhost:$PORT/navigate" \-H "Content-Type: application/json" \- -d '{"url":"https://app.example.com"}'+ -d '{"url":"https://app.pinchtab.com"}'# User interacts manually...sleep 3600 # 1 hour session@@ -434,7 +434,7 @@ ITEMS=("item1" "item2" "item3" ... "item1000")for ITEM in "${ITEMS[@]}"; docurl -s -X POST "http://localhost:9868/navigate" \-H "Content-Type: application/json" \- -d "{\"url\":\"https://api.example.com?item=$ITEM\"}"+ -d "{\"url\":\"https://api.pinchtab.com?item=$ITEM\"}"sleep 1 # Rate limitingdone@@ -468,7 +468,7 @@ for ITEM in "${ITEMS[@]}"; docurl -s -X POST "http://localhost:$PORT/navigate" \-H "Content-Type: application/json" \- -d "{\"url\":\"https://api.example.com?item=$ITEM\"}" &+ -d "{\"url\":\"https://api.pinchtab.com?item=$ITEM\"}" &((ITEM_INDEX++))done@@ -500,7 +500,7 @@ for i in "${!ITEMS[@]}"; do# Process itemif curl -s -X POST "http://localhost:9868/navigate" \-H "Content-Type: application/json" \- -d "{\"url\":\"https://api.example.com?item=$ITEM\"}" > /dev/null 2>&1; then+ -d "{\"url\":\"https://api.pinchtab.com?item=$ITEM\"}" > /dev/null 2>&1; thenRESULTS+=("$ITEM: OK")elseFAILED+=("$ITEM")@@ -515,7 +515,7 @@ echo "Retrying ${#FAILED[@]} failed items..."for ITEM in "${FAILED[@]}"; docurl -s -X POST "http://localhost:9868/navigate" \-H "Content-Type: application/json" \- -d "{\"url\":\"https://api.example.com?item=$ITEM\"}"+ -d "{\"url\":\"https://api.pinchtab.com?item=$ITEM\"}"doneecho "Results: ${#RESULTS[@]} OK, ${#FAILED[@]} failed"@@ -544,7 +544,7 @@ function safe_navigate() {-d "{\"url\":\"$URL\"}"}-safe_navigate 9868 "https://example.com" || echo "Navigation failed"+safe_navigate 9868 "https://pinchtab.com" || echo "Navigation failed"```### Timeout Handlingdiff --git a/docs/guides/headed-mode-guide.md b/docs/guides/headed-mode-guide.mdindex c6f41b66..29142d23 100644--- a/docs/guides/headed-mode-guide.md+++ b/docs/guides/headed-mode-guide.md@@ -355,13 +355,13 @@ For agents to show up with a name in the dashboard instead of "anonymous", theycurl -X POST http://localhost:9867/instances/$INST/navigate \-H "X-Agent-Id: mario" \-H "Content-Type: application/json" \- -d '{"url": "https://example.com"}'+ -d '{"url": "https://pinchtab.com"}'# Or directly to instancecurl -X POST http://localhost:9868/navigate \-H "X-Agent-Id: mario" \-H "Content-Type: application/json" \- -d '{"url": "https://example.com"}'+ -d '{"url": "https://pinchtab.com"}'```That's all it takes. The `X-Agent-Id` header tags every request, and the dashboard tracks it automatically. No registration, no config — just a header.@@ -415,7 +415,7 @@ No SSH tunnels. No VPN. No complex setup. Just a browser and a token.curl -X POST http://orchestrator:9867/instances/$INST/navigate \-H "X-Agent-Id: mario" \-H "Content-Type: application/json" \- -d '{"url": "https://example.com"}'+ -d '{"url": "https://pinchtab.com"}'```The dashboard automatically tracks which agent is doing what, where, and when.diff --git a/docs/guides/multi-instance.md b/docs/guides/multi-instance.mdindex 14b22d26..32a5e8d9 100644--- a/docs/guides/multi-instance.md+++ b/docs/guides/multi-instance.md@@ -49,14 +49,14 @@ Navigate the instance via the orchestrator (recommended):```bashcurl -X POST http://localhost:9867/instances/inst_a365262a/tabs/open \-H "Content-Type: application/json" \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'```**Response:**```json{"id": "tab_19949f62",- "url": "https://example.com",+ "url": "https://pinchtab.com","title": "Example Domain"}```@@ -71,7 +71,7 @@ Retrieve page snapshot using the tab ID:```bashTAB=$(curl -s -X POST http://localhost:9867/instances/inst_a365262a/tabs/open \- -d '{"url":"https://example.com"}' | jq -r '.id')+ -d '{"url":"https://pinchtab.com"}' | jq -r '.id')curl http://localhost:9867/tabs/$TAB/snapshot```@@ -104,11 +104,11 @@ Create 5 headless instances for concurrent scraping:#!/bin/bashURLS=(- "https://example.com/page1"- "https://example.com/page2"- "https://example.com/page3"- "https://example.com/page4"- "https://example.com/page5"+ "https://pinchtab.com/page1"+ "https://pinchtab.com/page2"+ "https://pinchtab.com/page3"+ "https://pinchtab.com/page4"+ "https://pinchtab.com/page5")INSTANCES=()@@ -255,7 +255,7 @@ for TASK in "${TASKS[@]}"; do# Send task to instance via orchestrator proxycurl -s -X POST "http://localhost:9867/instances/$ID/tabs/open" \-H "Content-Type: application/json" \- -d "{\"url\":\"https://api.example.com?task=$TASK\"}" > /dev/null &+ -d "{\"url\":\"https://api.pinchtab.com?task=$TASK\"}" > /dev/null &# Keep 10 requests in flight at a timeif (( (INSTANCE_INDEX + 1) % 10 == 0 )); then@@ -408,7 +408,7 @@ done# Now safe to usecurl -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'```### Instance State@@ -556,7 +556,7 @@ done# Now safe to navigatecurl -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'```Chrome lazy-initializes on first health check (~8-20 seconds).@@ -599,11 +599,11 @@ Frees ports and RAM for new instances.```bash# DO: Use orchestrator proxy (recommended)curl -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'# AVOID: Direct port access (less consistent)curl -X POST http://localhost:$PORT/tabs/open \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'```Orchestrator proxy ensures consistent routing and better monitoring.@@ -764,7 +764,7 @@ curl -X POST http://localhost:9867/instances/$OLD_INST/stop# Instance IDs are stable, but ports change on restart# Always use orchestrator proxy:curl http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'# Don't rely on cached port numbersPORT=$(curl http://localhost:9867/instances/$INST | jq -r '.port')diff --git a/docs/guides/raspberry-pi.md b/docs/guides/raspberry-pi.mdindex 9e3f3c17..a701d285 100644--- a/docs/guides/raspberry-pi.md+++ b/docs/guides/raspberry-pi.md@@ -327,7 +327,7 @@ npm install -g pinchtabcurl -X POST http://localhost:9867/tabs \-H "Content-Type: application/json" \-d '{- "url": "https://example.com",+ "url": "https://pinchtab.com","actions": [{"kind": "wait", "selector": ".content"}]@@ -364,7 +364,7 @@ const { chromium } = require('playwright');(async () => {const browser = await chromium.connectOverCDP('http://localhost:9867');const page = await browser.newPage();- await page.goto('https://example.com');+ await page.goto('https://pinchtab.com');console.log(await page.title());await browser.close();})();diff --git a/docs/headless-vs-headed.md b/docs/headless-vs-headed.mdindex 89b214b0..d1c26285 100644--- a/docs/headless-vs-headed.md+++ b/docs/headless-vs-headed.md@@ -260,7 +260,7 @@ DEV=$(pinchtab instance launch --mode headed | jq -r '.id')# Terminal 3: Build and test your automationcurl -X POST http://localhost:9867/instances/$DEV/navigate \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'# Verify behavior in the visible window while you develop# ... iterate on your script ...@@ -486,7 +486,7 @@ done# Now safe to usecurl -X POST http://localhost:9867/instances/$INST/navigate \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'```### Can't Connect to Instancediff --git a/docs/overview.md b/docs/overview.mdindex 62e8dac8..b084dc64 100644--- a/docs/overview.md+++ b/docs/overview.md@@ -9,7 +9,7 @@ PinchTab is a **standalone HTTP server** that gives you direct control over a Ch**CLI example:**```bash# Navigate-pinchtab nav https://example.com+pinchtab nav https://pinchtab.com# Get interactive elementspinchtab snap -i -c@@ -22,7 +22,7 @@ pinchtab click e5```bash# 1. Navigate to URL (returns tabId)TAB=$(curl -s -X POST http://localhost:9867/tab \- -d '{"action":"new","url":"https://example.com"}' | jq -r '.tabId')+ -d '{"action":"new","url":"https://pinchtab.com"}' | jq -r '.tabId')# 2. Get page structurecurl -s "http://localhost:9867/snapshot?tabId=$TAB&filter=interactive" | jqdiff --git a/docs/proposals/default-instance.md b/docs/proposals/default-instance.mdindex 7f1bf2a4..bf4ce87f 100644--- a/docs/proposals/default-instance.md+++ b/docs/proposals/default-instance.md@@ -103,7 +103,7 @@ Response:{"id": "tab_abc123","title": "Example Domain",- "url": "https://example.com/",+ "url": "https://pinchtab.com/","active": true}]@@ -113,13 +113,13 @@ Response:```bashcurl -X POST http://localhost:9867/tabs/open \-H "Content-Type: application/json" \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'Response:{"id": "tab_abc123","title": "Example Domain",- "url": "https://example.com/"+ "url": "https://pinchtab.com/"}```@@ -140,12 +140,12 @@ Response:```bashcurl -X POST http://localhost:9867/navigate \-H "Content-Type: application/json" \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'Response:{"status": "navigated",- "url": "https://example.com",+ "url": "https://pinchtab.com","title": "Example Domain"}```@@ -371,7 +371,7 @@ sleep 2# NavigateTAB=$(curl -s -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://example.com"}' | jq -r '.id')+ -d '{"url":"https://pinchtab.com"}' | jq -r '.id')# Snapshotcurl http://localhost:9867/tabs/$TAB/snapshot@@ -384,7 +384,7 @@ curl -X POST http://localhost:9867/start# Navigatecurl -X POST http://localhost:9867/navigate \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'# Snapshotcurl http://localhost:9867/snapshot@@ -490,7 +490,7 @@ POST /start?headed=true```bash#!/bin/bashcurl -X POST http://localhost:9867/start-curl -X POST http://localhost:9867/navigate -d '{"url":"https://example.com"}'+curl -X POST http://localhost:9867/navigate -d '{"url":"https://pinchtab.com"}'curl http://localhost:9867/snapshot | jq '.nodes'curl -X POST http://localhost:9867/stop```@@ -505,7 +505,7 @@ BASE = "http://localhost:9867"requests.post(f"{BASE}/start", json={"mode": "headless"})# Navigate-requests.post(f"{BASE}/navigate", json={"url": "https://example.com"})+requests.post(f"{BASE}/navigate", json={"url": "https://pinchtab.com"})# Snapshotsnap = requests.get(f"{BASE}/snapshot").json()@@ -529,7 +529,7 @@ async function automate() {// Navigateawait fetch(`${BASE}/navigate`, {method: "POST",- body: JSON.stringify({ url: "https://example.com" })+ body: JSON.stringify({ url: "https://pinchtab.com" })});// Snapshotdiff --git a/docs/references/api-reference.json b/docs/references/api-reference.jsonindex da2d2ff6..c6dd251e 100644--- a/docs/references/api-reference.json+++ b/docs/references/api-reference.json@@ -419,7 +419,7 @@"curl": true,"tldr": "View actions performed with this profile","curlExample": "curl \"http://localhost:9867/profiles/prof_278be87/logs?limit=50\"",- "curlExampleOutput": "[{\"timestamp\":\"2026-03-01T05:12:45Z\",\"action\":\"navigate\",\"url\":\"https://example.com\"},{\"timestamp\":\"2026-03-01T05:12:50Z\",\"action\":\"click\",\"selector\":\"e5\"}]",+ "curlExampleOutput": "[{\"timestamp\":\"2026-03-01T05:12:45Z\",\"action\":\"navigate\",\"url\":\"https://pinchtab.com\"},{\"timestamp\":\"2026-03-01T05:12:50Z\",\"action\":\"click\",\"selector\":\"e5\"}]","parameters": "id (string, path, required): Profile ID or name; limit (int, query, optional, default: 100)","payload": "N/A (GET request)","defaults": "Returns array of ActionRecord",@@ -463,10 +463,10 @@"tldr": "Navigate tab to URL","cli": true,"curl": true,- "cliExample": "pinchtab tab navigate <tabId> https://example.com",- "curlExample": "curl -X POST http://localhost:9867/tabs/tab_abc/navigate -d '{\"url\":\"https://example.com\",\"timeout\":30}'",+ "cliExample": "pinchtab tab navigate <tabId> https://pinchtab.com",+ "curlExample": "curl -X POST http://localhost:9867/tabs/tab_abc/navigate -d '{\"url\":\"https://pinchtab.com\",\"timeout\":30}'","parameters": "url (string, body, required); timeout (int, optional); blockImages (bool, optional); blockAds (bool, optional)",- "payload": "{\"url\":\"https://example.com\",\"timeout\":30}",+ "payload": "{\"url\":\"https://pinchtab.com\",\"timeout\":30}","defaults": "timeout=30s; returns {url, title, status}"},{@@ -604,7 +604,7 @@"curl": true,"curlExample": "curl -X POST http://localhost:9867/tabs/tab_abc/cookies -d '{\"action\":\"set\",\"cookies\":[{\"name\":\"key\",\"value\":\"val\"}]}'","parameters": "action (string, body, required: 'set' or 'delete'); cookies (array, body, required)",- "payload": "{\"action\":\"set\",\"cookies\":[{\"name\":\"session\",\"value\":\"abc123\",\"domain\":\".example.com\"}]}",+ "payload": "{\"action\":\"set\",\"cookies\":[{\"name\":\"session\",\"value\":\"abc123\",\"domain\":\".pinchtab.com\"}]}","defaults": "returns {set: [...], deleted: [...]}"},{diff --git a/docs/references/api-structure.md b/docs/references/api-structure.mdindex b38a08fa..3e78df01 100644--- a/docs/references/api-structure.md+++ b/docs/references/api-structure.md@@ -110,13 +110,13 @@ curl -X POST http://localhost:9867/tabs/tab_xyz789/action \**OLD:**```bashcurl -X POST http://localhost:9867/instances/inst_abc123/navigate \- -d '{"url": "https://example.com"}'+ -d '{"url": "https://pinchtab.com"}'```**NEW:**```bashcurl -X POST http://localhost:9867/tabs/tab_xyz789/navigate \- -d '{"url": "https://example.com"}'+ -d '{"url": "https://pinchtab.com"}'```---@@ -177,7 +177,7 @@ curl 'http://localhost:9867/tabs?instanceId=inst_abc123'# Navigate with optionscurl -X POST http://localhost:9867/tabs/tab_xyz/navigate \-d '{- "url": "https://example.com",+ "url": "https://pinchtab.com","timeout": 30,"blockImages": true,"blockAds": false@@ -289,7 +289,7 @@ pinchtab tabspinchtab --instance inst_abc123 tabs# Create tab-pinchtab --instance inst_abc123 tab new https://example.com+pinchtab --instance inst_abc123 tab new https://pinchtab.com# → tab_xyz789# Close tab@@ -299,7 +299,7 @@ pinchtab --tab tab_xyz789 close### Tab Operations```bash# Navigate-pinchtab --tab tab_xyz789 nav https://example.com+pinchtab --tab tab_xyz789 nav https://pinchtab.com# Snapshotpinchtab --tab tab_xyz789 snap -i -c@@ -348,7 +348,7 @@ TAB=$(pinchtab --instance $INST tab new | jq -r .id)### Work```bash# 4. Navigate-pinchtab --tab $TAB nav https://example.com+pinchtab --tab $TAB nav https://pinchtab.com# 5. Get page structurepinchtab --tab $TAB snap -i -c | jq .diff --git a/docs/references/cli-design.md b/docs/references/cli-design.mdindex c04f4538..6b651ee8 100644--- a/docs/references/cli-design.md+++ b/docs/references/cli-design.md@@ -49,12 +49,12 @@ pinchtab [--instance <id>] <action> [args] [flags]**Examples:**```bash# Default instance (auto-detected from PINCHTAB_INSTANCE env or from running instance)-pinchtab nav https://example.com+pinchtab nav https://pinchtab.compinchtab snap -i -cpinchtab click e5# Explicit instance-pinchtab --instance inst_abc123 nav https://example.com+pinchtab --instance inst_abc123 nav https://pinchtab.compinchtab --instance inst_abc123 snap```@@ -75,11 +75,11 @@ pinchtab --instance <id> tab <tabId> <action> Operate on specific tabpinchtab --instance inst_abc123 tabs # GET /instances/<id>/tabs# Create tab-pinchtab --instance inst_abc123 tab create https://example.com+pinchtab --instance inst_abc123 tab create https://pinchtab.com# POST /instances/<id>/tabs/open {url}# Navigate tab-pinchtab --instance inst_abc123 tab <tabId> navigate https://example.com+pinchtab --instance inst_abc123 tab <tabId> navigate https://pinchtab.com# POST /tabs/<tabId>/navigate {url}# Close tab@@ -95,14 +95,14 @@ pinchtab --instance inst_abc123 tab <tabId> lock --owner agent1 --ttl 60#### Option A: Flags (simple cases)```bash-pinchtab --instance <id> navigate https://example.com --block-images --block-ads --timeout 30+pinchtab --instance <id> navigate https://pinchtab.com --block-images --block-ads --timeout 30```Maps to:```jsonPOST /tabs/<tabId>/navigate{- "url": "https://example.com",+ "url": "https://pinchtab.com","blockImages": true,"blockAds": true,"timeout": 30@@ -156,30 +156,30 @@ EOF| `/instances/launch` | POST | `pinchtab instance launch --mode headed --port 9869` || `/instances/{id}/logs` | GET | `pinchtab instance <id> logs` || `/instances/{id}/stop` | POST | `pinchtab instance <id> stop` |-| `/instances/{id}/tabs/open` | POST | `pinchtab --instance <id> tab create https://example.com` |+| `/instances/{id}/tabs/open` | POST | `pinchtab --instance <id> tab create https://pinchtab.com` || `/instances/{id}/tabs` | GET | `pinchtab --instance <id> tabs` |### Browser Control (Single Instance)| Endpoint | HTTP | CLI Command ||----------|------|-------------|-| `/navigate` | POST | `pinchtab nav https://example.com` |+| `/navigate` | POST | `pinchtab nav https://pinchtab.com` || `/snapshot` | GET | `pinchtab snap -i -c` || `/screenshot` | GET | `pinchtab ss -o out.png` || `/action` | POST | `pinchtab click e5` || `/actions` | POST | `pinchtab action -f actions.json` |-| `/tab` | POST | `pinchtab tab create https://example.com` |+| `/tab` | POST | `pinchtab tab create https://pinchtab.com` || `/tabs` | GET | `pinchtab tabs` || `/evaluate` | POST | `pinchtab eval "document.title"` || `/tabs/{id}/pdf` | GET | `pinchtab pdf --tab <tabId> -o out.pdf --landscape` || `/text` | GET | `pinchtab text` || `/text` | GET | `pinchtab text --raw` || `/cookies` | GET | `pinchtab cookies` |-| `/cookies` | POST | `pinchtab cookies --set 'name=value; domain=.example.com'` |+| `/cookies` | POST | `pinchtab cookies --set 'name=value; domain=.pinchtab.com'` |### Orchestrator Proxying (Instance-scoped)| Endpoint | HTTP | CLI Command ||----------|------|-------------|-| `/tabs/{id}/navigate` | POST | `pinchtab instance navigate <id> https://example.com` |+| `/tabs/{id}/navigate` | POST | `pinchtab instance navigate <id> https://pinchtab.com` || `/tabs/{id}/snapshot` | GET | `pinchtab tab <tabId> snapshot -i` || `/tabs/{id}/screenshot` | GET | `pinchtab tab screenshot <tabId> -o out.jpg` || `/tabs/{id}/action` | POST | `pinchtab tab click <tabId> e5` |@@ -246,7 +246,7 @@ pinchtab --instance inst_abc123 snap -c > page.jsonpinchtab --instance inst_abc123 tabs# Create new tab-TAB_ID=$(pinchtab --instance inst_abc123 tab create https://example.com | jq -r .id)+TAB_ID=$(pinchtab --instance inst_abc123 tab create https://pinchtab.com | jq -r .id)# Lock tab (prevent other agents from using it)pinchtab --instance inst_abc123 tab $TAB_ID lock --owner my-agent --ttl 60diff --git a/docs/references/cli-quick-reference.md b/docs/references/cli-quick-reference.mdindex 84a4b3b4..439cfe00 100644--- a/docs/references/cli-quick-reference.md+++ b/docs/references/cli-quick-reference.md@@ -57,16 +57,16 @@ pinchtab instance inst_abc123 stop### Navigate```bash# Default instance-pinchtab nav https://example.com+pinchtab nav https://pinchtab.com# Specific instance-pinchtab --instance inst_abc123 nav https://example.com+pinchtab --instance inst_abc123 nav https://pinchtab.com# Open in new tab-pinchtab --instance inst_abc123 nav https://example.com --new-tab+pinchtab --instance inst_abc123 nav https://pinchtab.com --new-tab# Without images (faster)-pinchtab --instance inst_abc123 nav https://example.com --block-images+pinchtab --instance inst_abc123 nav https://pinchtab.com --block-images```### Snapshot page@@ -192,7 +192,7 @@ pinchtab --instance inst_abc123 tabs | jq '.tabs | length'### Create tab```bash# Create and get ID-TAB=$(pinchtab --instance inst_abc123 tab create https://example.com | jq -r .id)+TAB=$(pinchtab --instance inst_abc123 tab create https://pinchtab.com | jq -r .id)echo $TAB # tab_xyz789```@@ -330,7 +330,7 @@ done```bash# Navigate multiple instances concurrentlyfor inst in $(pinchtab instances | jq -r '.[] | .id'); do- (pinchtab --instance $inst nav https://example.com) &+ (pinchtab --instance $inst nav https://pinchtab.com) &donewait@@ -432,7 +432,7 @@ export PINCHTAB_NO_COLOR=1### Wait for page load, then interact```bash-pinchtab --instance inst_abc123 nav https://example.com+pinchtab --instance inst_abc123 nav https://pinchtab.comsleep 2 # Wait for pagepinchtab --instance inst_abc123 snap -i```@@ -447,7 +447,7 @@ pinchtab --instance inst_abc123 ss -o result.png### Form fill```bashpinchtab --instance inst_abc123 fill e1 "John Doe"-pinchtab --instance inst_abc123 fill e2 "[email protected]"+pinchtab --instance inst_abc123 fill e2 "[email protected]"pinchtab --instance inst_abc123 click e3 # Submit buttonsleep 2pinchtab --instance inst_abc123 snapdiff --git a/docs/references/endpoints.md b/docs/references/endpoints.mdindex edd4d01c..ae4198da 100644--- a/docs/references/endpoints.md+++ b/docs/references/endpoints.md@@ -156,7 +156,7 @@ GET /instances"port": "9869","startTime": "2026-02-28T18:35:20Z","tabs": [- {"id": "tab-3", "url": "https://api.example.com", "title": "API"}+ {"id": "tab-3", "url": "https://api.pinchtab.com", "title": "API"}]}]@@ -233,7 +233,7 @@ POST /instances/{id}/tabs/open```json{"tabId": "tab-1",- "url": "https://example.com",+ "url": "https://pinchtab.com","title": "Example Domain"}```@@ -254,7 +254,7 @@ curl -X POST http://localhost:9867/instances/work-9868/tabs/open \```bashTAB_JSON=$(curl -s -X POST http://localhost:9867/instances/work-9868/tabs/open \-H "Content-Type: application/json" \- -d '{"url":"https://example.com"}')+ -d '{"url":"https://pinchtab.com"}')TAB_ID=$(echo $TAB_JSON | jq -r '.tabId')echo "Opened tab: $TAB_ID"```@@ -386,7 +386,7 @@ POST /tabs/{id}/action{"kind": "type","ref": "e1",- "text": "[email protected]"+ "text": "[email protected]"}```@@ -394,7 +394,7 @@ POST /tabs/{id}/action```bashcurl -X POST http://localhost:9867/tabs/tab-1/action \-H "Content-Type: application/json" \- -d '{"kind":"type","ref":"e1","text":"[email protected]"}'+ -d '{"kind":"type","ref":"e1","text":"[email protected]"}'```---@@ -639,7 +639,7 @@ GET /tabs[{"instanceId": "work-9868", "tabId": "tab-1", "url": "https://linkedin.com", "title": "LinkedIn"},{"instanceId": "work-9868", "tabId": "tab-2", "url": "https://github.com", "title": "GitHub"},- {"instanceId": "scraping-9869", "tabId": "tab-3", "url": "https://api.example.com", "title": "API"}+ {"instanceId": "scraping-9869", "tabId": "tab-3", "url": "https://api.pinchtab.com", "title": "API"}]```@@ -686,7 +686,7 @@ echo $SNAP | jq '.elements[]' | head -5echo "Entering email..."curl -s -X POST "$BASE/instances/$INST_ID/action" \-H "Content-Type: application/json" \- -d "{\"kind\":\"type\",\"ref\":\"e1\",\"text\":\"[email protected]\",\"tabId\":\"$TAB_ID\"}"+ -d "{\"kind\":\"type\",\"ref\":\"e1\",\"text\":\"[email protected]\",\"tabId\":\"$TAB_ID\"}"# 5. Find password input (ref=e2) and typeecho "Entering password..."@@ -797,7 +797,7 @@ pinchtab instances # List allpinchtab launch --profile work --headed # Create# Navigate & interact-pinchtab nav https://example.com # Navigate (on default instance)+pinchtab nav https://pinchtab.com # Navigate (on default instance)pinchtab snap # Snapshotpinchtab click e5 # Clickpinchtab type e1 "text" # Typediff --git a/docs/references/profile-api.md b/docs/references/profile-api.mdindex d7c7e5db..8746390f 100644--- a/docs/references/profile-api.md+++ b/docs/references/profile-api.md@@ -342,7 +342,7 @@ curl 'http://localhost:9867/profiles/my-profile/logs?limit=1000'{"timestamp": "2026-03-01T05:12:45Z","action": "navigate",- "url": "https://example.com"+ "url": "https://pinchtab.com"},{"timestamp": "2026-03-01T05:12:50Z",@@ -388,7 +388,7 @@ curl http://localhost:9867/profiles/my-profile/analytics},"lastUsed": "2026-03-01T05:12:50Z","commonHosts": [- "example.com",+ "pinchtab.com","google.com","github.com"],diff --git a/docs/references/tabs-api.md b/docs/references/tabs-api.mdindex 18a14036..dc4df310 100644--- a/docs/references/tabs-api.md+++ b/docs/references/tabs-api.md@@ -17,7 +17,7 @@ curl http://localhost:9867/tabs | jq .{"id": "tab_abc123","instanceId": "inst_xyz",- "url": "https://example.com",+ "url": "https://pinchtab.com","title": "Example Domain","status": "ready"}@@ -27,17 +27,17 @@ curl http://localhost:9867/tabs | jq .### Open a New Tab```bash# CLI (create new tab in instance)-pinchtab tab open inst_xyz https://example.com+pinchtab tab open inst_xyz https://pinchtab.com# Curlcurl -X POST http://localhost:9867/instances/{id}/tabs/open \-H "Content-Type: application/json" \- -d '{"url": "https://example.com"}'+ -d '{"url": "https://pinchtab.com"}'# Response{"tabId": "tab_abc123",- "url": "https://example.com",+ "url": "https://pinchtab.com","title": "Example Domain"}```@@ -54,7 +54,7 @@ curl http://localhost:9867/tabs/tab_abc123{"id": "tab_abc123","instanceId": "inst_xyz",- "url": "https://example.com",+ "url": "https://pinchtab.com","title": "Example Domain","status": "ready"}@@ -119,7 +119,7 @@ tab_abc12345**CLI:**```bash# Create tab in instance with URL-pinchtab tab open inst_xyz https://example.com+pinchtab tab open inst_xyz https://pinchtab.com# Create tab without initial URLpinchtab tab open inst_xyz@@ -135,13 +135,13 @@ curl -X POST http://localhost:9867/instances/{id}/tabs/open \# With URLcurl -X POST http://localhost:9867/instances/{id}/tabs/open \-H "Content-Type: application/json" \- -d '{"url": "https://example.com"}'+ -d '{"url": "https://pinchtab.com"}'```**Request Body:**```json{- "url": "https://example.com"+ "url": "https://pinchtab.com"}```@@ -152,7 +152,7 @@ curl -X POST http://localhost:9867/instances/{id}/tabs/open \```json{"tabId": "tab_abc123",- "url": "https://example.com",+ "url": "https://pinchtab.com","title": "Example Domain"}```@@ -190,7 +190,7 @@ curl 'http://localhost:9867/tabs?instanceId=inst_xyz' | jq .{"id": "tab_abc123","instanceId": "inst_xyz",- "url": "https://example.com",+ "url": "https://pinchtab.com","title": "Example Domain","status": "ready","createdAt": "2026-03-01T05:25:30Z"@@ -232,7 +232,7 @@ curl http://localhost:9867/tabs/tab_abc123 | jq .{"id": "tab_abc123","instanceId": "inst_xyz",- "url": "https://example.com",+ "url": "https://pinchtab.com","title": "Example Domain","status": "ready","createdAt": "2026-03-01T05:25:30Z"@@ -286,7 +286,7 @@ INST=$(pinchtab instance start --mode headed | jq -r .id)echo "Instance: $INST"# Open first tab-TAB1=$(pinchtab tab open $INST https://example.com | jq -r .id)+TAB1=$(pinchtab tab open $INST https://pinchtab.com | jq -r .id)echo "Tab 1: $TAB1"# Open second tab@@ -320,7 +320,7 @@ pinchtab instance stop $INSTINST=$1URLS=(- "https://example.com"+ "https://pinchtab.com""https://google.com""https://github.com""https://stackoverflow.com"@@ -368,7 +368,7 @@ TAB=$(pinchtab tab open $INST | jq -r .id)echo "Tab: $TAB"# Navigate through multiple sites-SITES=("example.com" "google.com" "github.com")+SITES=("pinchtab.com" "google.com" "github.com")for site in "${SITES[@]}"; doecho "Navigating to $site..."@@ -393,7 +393,7 @@ pinchtab instance stop $INSTpinchtab instances# Open tab in instance-pinchtab tab open inst_abc123 https://example.com+pinchtab tab open inst_abc123 https://pinchtab.com# List all tabspinchtab tabs@@ -408,7 +408,7 @@ pinchtab tab info tab_xyz789pinchtab tab close tab_xyz789# Open multiple tabs-for url in example.com google.com github.com; do+for url in pinchtab.com google.com github.com; dopinchtab tab open inst_abc123 https://$urldone```@@ -424,7 +424,7 @@ doneINST=$(pinchtab instance start --mode headed | jq -r .id)TAB1=$(curl -s -X POST "http://localhost:9867/instances/$INST/tabs/open" \- -d "{\"url\":\"https://example.com\"}" | jq -r .tabId)+ -d "{\"url\":\"https://pinchtab.com\"}" | jq -r .tabId)TAB2=$(curl -s -X POST "http://localhost:9867/instances/$INST/tabs/open" \-d "{\"url\":\"https://google.com\"}" | jq -r .tabId)@@ -447,7 +447,7 @@ inst_id = inst_resp.json()["id"]print(f"Instance: {inst_id}")# Open tabs-for url in ["https://example.com", "https://google.com"]:+for url in ["https://pinchtab.com", "https://google.com"]:resp = requests.post(f"{BASE}/instances/{inst_id}/tabs/open",json={"url": url})tab = resp.json()@@ -481,7 +481,7 @@ async function tabWorkflow() {console.log(`Instance: ${inst.id}`);// Open tabs- const urls = ["https://example.com", "https://google.com"];+ const urls = ["https://pinchtab.com", "https://google.com"];const tabs = [];for (const url of urls) {@@ -518,7 +518,7 @@ tabWorkflow().catch(console.error);```bashcurl -X POST http://localhost:9867/instances/{id}/tabs/open \- -d '{"url":"https://example.com"}'+ -d '{"url":"https://pinchtab.com"}'# Response (404){@@ -562,7 +562,7 @@ curl -X POST http://localhost:9867/instances/{id}/tabs/open -d 'invalid'TAB=$(pinchtab tab open $INST | jq -r .id)# 2. Do work (navigate, interact, etc.)-pinchtab tab navigate $TAB https://example.com+pinchtab tab navigate $TAB https://pinchtab.com# 3. Get resultspinchtab tab snapshot $TAB@@ -675,14 +675,14 @@ Once you have a tab ID, you can perform full browser control operations on it.**CLI:**```bash-pinchtab tab navigate <tab-id> https://example.com-pinchtab tab navigate <tab-id> https://example.com --timeout 30+pinchtab tab navigate <tab-id> https://pinchtab.com+pinchtab tab navigate <tab-id> https://pinchtab.com --timeout 30```**Curl:**```bashcurl -X POST http://localhost:9867/tabs/tab_abc/navigate \- -d '{"url":"https://example.com","timeout":30,"blockImages":true}'+ -d '{"url":"https://pinchtab.com","timeout":30,"blockImages":true}'```### Get Snapshot@@ -878,7 +878,7 @@ TAB=$(pinchtab tab new $INST | jq -r .id)echo "Tab: $TAB"# Navigate-pinchtab tab navigate $TAB https://example.com+pinchtab tab navigate $TAB https://pinchtab.comsleep 2# Get snapshotdiff --git a/docs/showcase.md b/docs/showcase.mdindex 9e0962e0..b7b3a138 100644--- a/docs/showcase.md+++ b/docs/showcase.md@@ -80,7 +80,7 @@ sleep 2```bashTAB=$(curl -s -X POST http://localhost:9867/instances/inst_abc123/tabs/open \-H "Content-Type: application/json" \- -d '{"url":"https://example.com"}' | jq -r '.id')+ -d '{"url":"https://pinchtab.com"}' | jq -r '.id')echo "Tab created: $TAB"```@@ -90,7 +90,7 @@ echo "Tab created: $TAB"{"id": "tab_def456","title": "Example Domain",- "url": "https://example.com/"+ "url": "https://pinchtab.com/"}```@@ -110,7 +110,7 @@ curl "http://localhost:9867/tabs/$TAB/text"**Complete script:**```bash#!/bin/bash-URL="https://example.com"+URL="https://pinchtab.com"# Step 1: Create instanceINST=$(curl -s -X POST http://localhost:9867/instances/launch \@@ -156,7 +156,7 @@ sleep 2TAB=$(curl -s -X POST http://localhost:9867/instances/$INST/tabs/open \-H "Content-Type: application/json" \- -d '{"url":"https://example.com/interactive"}' | jq -r '.id')+ -d '{"url":"https://pinchtab.com/interactive"}' | jq -r '.id')echo "Instance: $INST, Tab: $TAB"```@@ -204,7 +204,7 @@ curl "http://localhost:9867/tabs/$TAB/snapshot" | jq '.nodes'**Complete script:**```bash#!/bin/bash-URL="https://example.com/interactive"+URL="https://pinchtab.com/interactive"# Step 1: Create instanceINST=$(curl -s -X POST http://localhost:9867/instances/launch \@@ -260,7 +260,7 @@ sleep 2TAB=$(curl -s -X POST http://localhost:9867/instances/$INST/tabs/open \-H "Content-Type: application/json" \- -d '{"url":"https://example.com/login"}' | jq -r '.id')+ -d '{"url":"https://pinchtab.com/login"}' | jq -r '.id')echo "Instance: $INST, Tab: $TAB"```@@ -293,7 +293,7 @@ curl -s "http://localhost:9867/tabs/$TAB/snapshot" | jq '.nodes[] | select(.role```bashcurl -X POST http://localhost:9867/tabs/$TAB/action \-H "Content-Type: application/json" \- -d '{"action":"fill","ref":"e3","text":"[email protected]"}'+ -d '{"action":"fill","ref":"e3","text":"[email protected]"}'```**Step 4: Fill password field**@@ -330,7 +330,7 @@ echo "Instance: $INST"sleep 2TAB=$(curl -s -X POST http://localhost:9867/instances/$INST/tabs/open \-H "Content-Type: application/json" \- -d '{"url":"https://example.com/login"}' | jq -r '.id')+ -d '{"url":"https://pinchtab.com/login"}' | jq -r '.id')echo "Tab: $TAB"@@ -342,7 +342,7 @@ curl -s "http://localhost:9867/tabs/$TAB/snapshot" | \# Step 4: Fill emailcurl -s -X POST http://localhost:9867/tabs/$TAB/action \-H "Content-Type: application/json" \- -d '{"action":"fill","ref":"e3","text":"[email protected]"}'+ -d '{"action":"fill","ref":"e3","text":"[email protected]"}'# Step 5: Fill passwordcurl -s -X POST http://localhost:9867/tabs/$TAB/action \@@ -511,7 +511,7 @@ sleep 2TAB=$(curl -s -X POST http://localhost:9867/instances/$INST/tabs/open \-H "Content-Type: application/json" \- -d '{"url":"https://example.com/report"}' | jq -r '.id')+ -d '{"url":"https://pinchtab.com/report"}' | jq -r '.id')echo "Instance: $INST, Tab: $TAB"```@@ -540,7 +540,7 @@ sleep 2echo "Navigating to report page..."TAB=$(curl -s -X POST http://localhost:9867/instances/$INST/tabs/open \-H "Content-Type: application/json" \- -d '{"url":"https://example.com/report"}' | jq -r '.id')+ -d '{"url":"https://pinchtab.com/report"}' | jq -r '.id')echo "Tab: $TAB"@@ -587,7 +587,7 @@ INST=$(curl -s -X POST http://localhost:9867/instances/launch \-d '{"mode":"headless"}' | jq -r '.id')curl -X POST http://localhost:9867/instances/$INST/tabs/open \- -d '{"url":"https://example.com"}' # Likely timeout or error+ -d '{"url":"https://pinchtab.com"}' # Likely timeout or error# CORRECT - wait for Chromesleep 2diff --git a/internal/bridge/cdp_test.go b/internal/bridge/cdp_test.goindex e6fbf6db..f6b8fae2 100644--- a/internal/bridge/cdp_test.go+++ b/internal/bridge/cdp_test.go@@ -32,7 +32,7 @@ func TestNavigatePage_ContextCancelled(t *testing.T) {ctx, cancel := context.WithCancel(context.Background())cancel()- err := NavigatePage(ctx, "https://example.com")+ err := NavigatePage(ctx, "https://pinchtab.com")if err == nil {t.Error("expected error for cancelled context")}diff --git a/internal/bridge/snapshot_extra_test.go b/internal/bridge/snapshot_extra_test.goindex b1d0951d..bdb0e768 100644--- a/internal/bridge/snapshot_extra_test.go+++ b/internal/bridge/snapshot_extra_test.go@@ -8,10 +8,10 @@ import (func TestFormatSnapshotCompact_Basic(t *testing.T) {nodes := []A11yNode{{Ref: "e0", Role: "button", Name: "Submit"},- {Ref: "e1", Role: "textbox", Name: "Email", Value: "[email protected]"},+ {Ref: "e1", Role: "textbox", Name: "Email", Value: "[email protected]"},}got := FormatSnapshotCompact(nodes)- want := "e0:button \"Submit\"\ne1:textbox \"Email\" val=\"[email protected]\"\n"+ want := "e0:button \"Submit\"\ne1:textbox \"Email\" val=\"[email protected]\"\n"if got != want {t.Errorf("got:\n%s\nwant:\n%s", got, want)}diff --git a/internal/bridge/state_test.go b/internal/bridge/state_test.goindex b5d04b3b..2371d6d0 100644--- a/internal/bridge/state_test.go+++ b/internal/bridge/state_test.go@@ -55,7 +55,7 @@ func TestMarkCleanExit_NoPatch(t *testing.T) {func TestSessionState_Marshal(t *testing.T) {state := SessionState{Tabs: []TabState{- {ID: "tab1", URL: "https://example.com", Title: "Example"},+ {ID: "tab1", URL: "https://pinchtab.com", Title: "Example"},{ID: "tab2", URL: "https://google.com", Title: "Google"},},SavedAt: "2026-02-17T07:00:00Z",@@ -74,8 +74,8 @@ func TestSessionState_Marshal(t *testing.T) {if len(decoded.Tabs) != 2 {t.Errorf("expected 2 tabs, got %d", len(decoded.Tabs))}- if decoded.Tabs[0].URL != "https://example.com" {- t.Errorf("expected example.com, got %s", decoded.Tabs[0].URL)+ if decoded.Tabs[0].URL != "https://pinchtab.com" {+ t.Errorf("expected pinchtab.com, got %s", decoded.Tabs[0].URL)}}@@ -145,7 +145,7 @@ func TestIsTransientURL(t *testing.T) {}persistent := []string{- "https://example.com",+ "https://pinchtab.com","https://github.com/pinchtab/pinchtab","https://www.google.com/search?q=test","https://httpbin.org/get",diff --git a/internal/handlers/actions_test.go b/internal/handlers/actions_test.goindex 3fd49403..3cb70371 100644--- a/internal/handlers/actions_test.go+++ b/internal/handlers/actions_test.go@@ -187,7 +187,7 @@ func TestHandleSetCookies_EmptyURL(t *testing.T) {func TestHandleSetCookies_EmptyCookies(t *testing.T) {h := New(&mockBridge{}, &config.RuntimeConfig{}, nil, nil, nil)- body := `{"url": "https://example.com", "cookies": []}`+ body := `{"url": "https://pinchtab.com", "cookies": []}`req := httptest.NewRequest("POST", "/cookies", bytes.NewReader([]byte(body)))req.Header.Set("Content-Type", "application/json")w := httptest.NewRecorder()diff --git a/internal/handlers/cookies_test.go b/internal/handlers/cookies_test.goindex 417e42e5..6c6a10f3 100644--- a/internal/handlers/cookies_test.go+++ b/internal/handlers/cookies_test.go@@ -23,7 +23,7 @@ func TestHandleSetCookies_InvalidJSON(t *testing.T) {func TestHandleSetCookies_NoTab(t *testing.T) {h := New(&failMockBridge{}, &config.RuntimeConfig{}, nil, nil, nil)- body := `{"url":"https://example.com","cookies":[{"name":"a","value":"b"}],"tabId":"nonexistent"}`+ body := `{"url":"https://pinchtab.com","cookies":[{"name":"a","value":"b"}],"tabId":"nonexistent"}`req := httptest.NewRequest("POST", "/cookies", bytes.NewReader([]byte(body)))w := httptest.NewRecorder()@@ -76,7 +76,7 @@ func TestHandleTabGetCookies_NoTab(t *testing.T) {func TestHandleTabSetCookies_TabIDMismatch(t *testing.T) {h := New(&mockBridge{}, &config.RuntimeConfig{}, nil, nil, nil)- body := `{"tabId":"tab_other","url":"https://example.com","cookies":[{"name":"a","value":"b"}]}`+ body := `{"tabId":"tab_other","url":"https://pinchtab.com","cookies":[{"name":"a","value":"b"}]}`req := httptest.NewRequest("POST", "/tabs/tab_abc/cookies", bytes.NewReader([]byte(body)))req.SetPathValue("id", "tab_abc")w := httptest.NewRecorder()@@ -88,7 +88,7 @@ func TestHandleTabSetCookies_TabIDMismatch(t *testing.T) {func TestHandleTabSetCookies_NoTab(t *testing.T) {h := New(&failMockBridge{}, &config.RuntimeConfig{}, nil, nil, nil)- body := `{"url":"https://example.com","cookies":[{"name":"a","value":"b"}]}`+ body := `{"url":"https://pinchtab.com","cookies":[{"name":"a","value":"b"}]}`req := httptest.NewRequest("POST", "/tabs/tab_abc/cookies", bytes.NewReader([]byte(body)))req.SetPathValue("id", "tab_abc")w := httptest.NewRecorder()diff --git a/internal/handlers/download_test.go b/internal/handlers/download_test.goindex b6abb1ef..0fae50d5 100644--- a/internal/handlers/download_test.go+++ b/internal/handlers/download_test.go@@ -34,16 +34,16 @@ func TestValidateDownloadURL(t *testing.T) {url stringwantErr bool}{- {"valid https", "https://example.com/file.pdf", false},- {"valid http", "http://example.com/page", false},+ {"valid https", "https://pinchtab.com/file.pdf", false},+ {"valid http", "http://pinchtab.com/page", false},{"file scheme", "file:///etc/passwd", true},- {"ftp scheme", "ftp://example.com/file", true},+ {"ftp scheme", "ftp://pinchtab.com/file", true},{"data scheme", "data:text/html,hello", true},{"localhost", "http://localhost:8080/secret", true},{"loopback ipv4", "http://127.0.0.1/secret", true},{"loopback ipv6", "http://[::1]/secret", true},- {"empty scheme", "://example.com", true},- {"no scheme", "example.com", true},+ {"empty scheme", "://pinchtab.com", true},+ {"no scheme", "pinchtab.com", true},}for _, tt := range tests {t.Run(tt.name, func(t *testing.T) {@@ -74,7 +74,7 @@ func TestHandleDownload_SSRFBlocked(t *testing.T) {func TestHandleTabDownload_MissingTabID(t *testing.T) {h := New(&mockBridge{}, &config.RuntimeConfig{AllowDownload: true}, nil, nil, nil)- req := httptest.NewRequest("GET", "/tabs//download?url=https://example.com", nil)+ req := httptest.NewRequest("GET", "/tabs//download?url=https://pinchtab.com", nil)w := httptest.NewRecorder()h.HandleTabDownload(w, req)if w.Code != http.StatusBadRequest {@@ -84,7 +84,7 @@ func TestHandleTabDownload_MissingTabID(t *testing.T) {func TestHandleTabDownload_NoTab(t *testing.T) {h := New(&mockBridge{failTab: true}, &config.RuntimeConfig{AllowDownload: true}, nil, nil, nil)- req := httptest.NewRequest("GET", "/tabs/tab_abc/download?url=https://example.com", nil)+ req := httptest.NewRequest("GET", "/tabs/tab_abc/download?url=https://pinchtab.com", nil)req.SetPathValue("id", "tab_abc")w := httptest.NewRecorder()h.HandleTabDownload(w, req)@@ -95,7 +95,7 @@ func TestHandleTabDownload_NoTab(t *testing.T) {func TestHandleDownload_Disabled(t *testing.T) {h := New(&mockBridge{}, &config.RuntimeConfig{}, nil, nil, nil)- req := httptest.NewRequest("GET", "/download?url=https://example.com/file.txt", nil)+ req := httptest.NewRequest("GET", "/download?url=https://pinchtab.com/file.txt", nil)w := httptest.NewRecorder()h.HandleDownload(w, req)if w.Code != 403 {diff --git a/internal/handlers/handlers_test.go b/internal/handlers/handlers_test.goindex c759e6c9..61086c62 100644--- a/internal/handlers/handlers_test.go+++ b/internal/handlers/handlers_test.go@@ -125,7 +125,7 @@ func TestHandleNavigate(t *testing.T) {h := New(m, cfg, nil, nil, nil)// 1. Valid POST request- body := `{"url": "https://example.com"}`+ body := `{"url": "https://pinchtab.com"}`req := httptest.NewRequest("POST", "/navigate", bytes.NewReader([]byte(body)))w := httptest.NewRecorder()h.HandleNavigate(w, req)@@ -136,7 +136,7 @@ func TestHandleNavigate(t *testing.T) {}// 2. Valid GET request (ergonomic alias path style)- req = httptest.NewRequest("GET", "/nav?url=https%3A%2F%2Fexample.com", nil)+ req = httptest.NewRequest("GET", "/nav?url=https%3A%2F%2Fpinchtab.com", nil)w = httptest.NewRecorder()h.HandleNavigate(w, req)if w.Code != 200 && w.Code != 500 {diff --git a/internal/handlers/health_tabs_test.go b/internal/handlers/health_tabs_test.goindex d2b4619a..5faf8a5c 100644--- a/internal/handlers/health_tabs_test.go+++ b/internal/handlers/health_tabs_test.go@@ -85,7 +85,7 @@ func TestHandleHealth_Success(t *testing.T) {// Create a mock bridge that returns targetsmockBridge := &MockBridge{targets: []*target.Info{- {TargetID: "target1", URL: "https://example.com", Title: "Example"},+ {TargetID: "target1", URL: "https://pinchtab.com", Title: "Example"},},}@@ -138,7 +138,7 @@ func TestHandleTabs_NilBridge(t *testing.T) {func TestHandleTabs_Success(t *testing.T) {mockBridge := &MockBridge{targets: []*target.Info{- {TargetID: "tab1", URL: "https://example.com", Title: "Example", Type: "page"},+ {TargetID: "tab1", URL: "https://pinchtab.com", Title: "Example", Type: "page"},{TargetID: "tab2", URL: "https://google.com", Title: "Google", Type: "page"},},}@@ -220,7 +220,7 @@ func TestHandleHealth_EnsureChromeFailure(t *testing.T) {func TestHandleHealth_EnsureChromeSuccess(t *testing.T) {mockBridge := &MockBridge{targets: []*target.Info{- {TargetID: "target1", URL: "https://example.com", Title: "Example"},+ {TargetID: "target1", URL: "https://pinchtab.com", Title: "Example"},},ensureChromeCalled: false,ensureChromeErr: "", // No errordiff --git a/internal/handlers/navigation.go b/internal/handlers/navigation.goindex b98c82fb..0916b415 100644--- a/internal/handlers/navigation.go+++ b/internal/handlers/navigation.go@@ -39,7 +39,7 @@ const maxBodySize = 1 << 20//// curl -X POST http://localhost:9867/navigate \// -H "Content-Type: application/json" \-// -d '{"url":"https://example.com"}'+// -d '{"url":"https://pinchtab.com"}'//// @Example curl navigate existing://@@ -49,7 +49,7 @@ const maxBodySize = 1 << 20//// @Example cli://-// pinchtab nav https://example.com+// pinchtab nav https://pinchtab.comfunc (h *Handlers) HandleNavigate(w http.ResponseWriter, r *http.Request) {// Ensure Chrome is initializedif err := h.ensureChrome(); err != nil {@@ -149,7 +149,7 @@ func (h *Handlers) HandleNavigate(w http.ResponseWriter, r *http.Request) {}if req.NewTab {- // Block dangerous/unsupported schemes; allow bare hostnames (e.g. "example.com")+ // Block dangerous/unsupported schemes; allow bare hostnames (e.g. "pinchtab.com")// which Chrome handles gracefully by prepending https://.if parsed, err := url.Parse(req.URL); err == nil && parsed.Scheme != "" {blocked := parsed.Scheme == "javascript" || parsed.Scheme == "vbscript" || parsed.Scheme == "data"diff --git a/internal/handlers/navigation_test.go b/internal/handlers/navigation_test.goindex 653b02f8..618dd94a 100644--- a/internal/handlers/navigation_test.go+++ b/internal/handlers/navigation_test.go@@ -20,7 +20,7 @@ func TestHandleNavigate_InvalidJSON(t *testing.T) {func TestHandleTabNavigate_MissingTabID(t *testing.T) {h := New(&mockBridge{}, &config.RuntimeConfig{}, nil, nil, nil)- req := httptest.NewRequest("POST", "/tabs//navigate", bytes.NewReader([]byte(`{"url":"https://example.com"}`)))+ req := httptest.NewRequest("POST", "/tabs//navigate", bytes.NewReader([]byte(`{"url":"https://pinchtab.com"}`)))w := httptest.NewRecorder()h.HandleTabNavigate(w, req)if w.Code != 400 {@@ -30,7 +30,7 @@ func TestHandleTabNavigate_MissingTabID(t *testing.T) {func TestHandleTabNavigate_TabIDMismatch(t *testing.T) {h := New(&mockBridge{}, &config.RuntimeConfig{}, nil, nil, nil)- req := httptest.NewRequest("POST", "/tabs/tab_abc/navigate", bytes.NewReader([]byte(`{"tabId":"tab_other","url":"https://example.com"}`)))+ req := httptest.NewRequest("POST", "/tabs/tab_abc/navigate", bytes.NewReader([]byte(`{"tabId":"tab_other","url":"https://pinchtab.com"}`)))req.SetPathValue("id", "tab_abc")w := httptest.NewRecorder()h.HandleTabNavigate(w, req)diff --git a/internal/instance/instance_test.go b/internal/instance/instance_test.goindex fe99678d..7749699a 100644--- a/internal/instance/instance_test.go+++ b/internal/instance/instance_test.go@@ -155,7 +155,7 @@ func TestLocator_CacheMiss_QueriesBridges(t *testing.T) {inst, _ := repo.Launch("default", "9868", true)// Set up fetcher to return tabs for this instance.- fetcher.AddTab("9868", "tab_xyz", "https://example.com")+ fetcher.AddTab("9868", "tab_xyz", "https://pinchtab.com")found, err := locator.FindInstanceByTabID("tab_xyz")if err != nil {@@ -178,7 +178,7 @@ func TestLocator_TabNotFound(t *testing.T) {locator := instance.NewLocator(repo, fetcher)_, _ = repo.Launch("default", "9868", true)- fetcher.AddTab("9868", "tab_abc", "https://example.com")+ fetcher.AddTab("9868", "tab_abc", "https://pinchtab.com")_, err := locator.FindInstanceByTabID("nonexistent")if err == nil {diff --git a/internal/profiles/identity_test.go b/internal/profiles/identity_test.goindex c50f6647..3ac3c95b 100644--- a/internal/profiles/identity_test.go+++ b/internal/profiles/identity_test.go@@ -21,7 +21,7 @@ func TestReadChromeProfileIdentity(t *testing.T) {"info_cache": {"Default": {"name": "Work Profile",- "user_name": "[email protected]",+ "user_name": "[email protected]","gaia_name": "Work User","gaia_id": "12345","is_consented_primary_account": true@@ -34,7 +34,7 @@ func TestReadChromeProfileIdentity(t *testing.T) {}name, email, accName, hasAcc = readChromeProfileIdentity(tmpDir)- if name != "Work Profile" || email != "[email protected]" || accName != "Work User" || !hasAcc {+ if name != "Work Profile" || email != "[email protected]" || accName != "Work User" || !hasAcc {t.Errorf("Local State parsing failed: got %q, %q, %q, %v", name, email, accName, hasAcc)}@@ -46,7 +46,7 @@ func TestReadChromeProfileIdentity(t *testing.T) {prefsContent := `{"account_info": [{- "email": "[email protected]",+ "email": "[email protected]","full_name": "Pref User","gaia": "67890"}@@ -57,7 +57,7 @@ func TestReadChromeProfileIdentity(t *testing.T) {}name, email, accName, hasAcc = readChromeProfileIdentity(tmpDir)- if name != "Work Profile" || email != "[email protected]" || accName != "Pref User" || !hasAcc {+ if name != "Work Profile" || email != "[email protected]" || accName != "Pref User" || !hasAcc {t.Errorf("Preferences parsing/override failed: got %q, %q, %q, %v", name, email, accName, hasAcc)}}diff --git a/internal/profiles/profiles_test.go b/internal/profiles/profiles_test.goindex 3e199716..ddb6c6d7 100644--- a/internal/profiles/profiles_test.go+++ b/internal/profiles/profiles_test.go@@ -103,7 +103,7 @@ func TestProfileManagerListReadsAccountFromPreferences(t *testing.T) {}prefsPath := filepath.Join(dir, profileID("acc-pref"), "Default", "Preferences")- prefs := `{"account_info":[{"email":"[email protected]","full_name":"Alice"}]}`+ prefs := `{"account_info":[{"email":"[email protected]","full_name":"Alice"}]}`if err := os.WriteFile(prefsPath, []byte(prefs), 0644); err != nil {t.Fatal(err)}@@ -115,8 +115,8 @@ func TestProfileManagerListReadsAccountFromPreferences(t *testing.T) {if len(profiles) != 1 {t.Fatalf("expected 1 profile, got %d", len(profiles))}- if profiles[0].AccountEmail != "[email protected]" {- t.Fatalf("expected account email [email protected], got %q", profiles[0].AccountEmail)+ if profiles[0].AccountEmail != "[email protected]" {+ t.Fatalf("expected account email [email protected], got %q", profiles[0].AccountEmail)}if profiles[0].AccountName != "Alice" {t.Fatalf("expected account name Alice, got %q", profiles[0].AccountName)@@ -134,7 +134,7 @@ func TestProfileManagerListReadsLocalStateIdentity(t *testing.T) {}localStatePath := filepath.Join(dir, profileID("acc-local"), "Local State")- localState := `{"profile":{"info_cache":{"Default":{"name":"Work","user_name":"[email protected]","gaia_name":"Bob","gaia_id":"123"}}}}`+ localState := `{"profile":{"info_cache":{"Default":{"name":"Work","user_name":"[email protected]","gaia_name":"Bob","gaia_id":"123"}}}}`if err := os.WriteFile(localStatePath, []byte(localState), 0644); err != nil {t.Fatal(err)}@@ -149,8 +149,8 @@ func TestProfileManagerListReadsLocalStateIdentity(t *testing.T) {if profiles[0].ChromeProfileName != "Work" {t.Fatalf("expected chrome profile name Work, got %q", profiles[0].ChromeProfileName)}- if profiles[0].AccountEmail != "[email protected]" {- t.Fatalf("expected account email [email protected], got %q", profiles[0].AccountEmail)+ if profiles[0].AccountEmail != "[email protected]" {+ t.Fatalf("expected account email [email protected], got %q", profiles[0].AccountEmail)}if profiles[0].AccountName != "Bob" {t.Fatalf("expected account name Bob, got %q", profiles[0].AccountName)@@ -220,7 +220,7 @@ func TestActionTracker(t *testing.T) {Timestamp: time.Now().Add(time.Duration(i) * time.Second),Method: "GET",Endpoint: "/snapshot",- URL: "https://example.com",+ URL: "https://pinchtab.com",DurationMs: 100,Status: 200,})diff --git a/internal/semantic/semantic_test.go b/internal/semantic/semantic_test.goindex fcb87ba0..e82b1904 100644--- a/internal/semantic/semantic_test.go+++ b/internal/semantic/semantic_test.go@@ -24,8 +24,8 @@ func TestComposite(t *testing.T) {},{name: "role name and value",- desc: ElementDescriptor{Ref: "e1", Role: "textbox", Name: "Email", Value: "[email protected]"},- want: "textbox: Email [[email protected]]",+ desc: ElementDescriptor{Ref: "e1", Role: "textbox", Name: "Email", Value: "[email protected]"},+ want: "textbox: Email [[email protected]]",},{name: "name only",@@ -756,10 +756,10 @@ func complexTableElements() []ElementDescriptor {{Ref: "e7", Role: "columnheader", Name: "Role"},{Ref: "e8", Role: "columnheader", Name: "Status"},{Ref: "e9", Role: "columnheader", Name: "Actions"},- {Ref: "e10", Role: "cell", Name: "John Doe", Value: "[email protected]"},+ {Ref: "e10", Role: "cell", Name: "John Doe", Value: "[email protected]"},{Ref: "e11", Role: "button", Name: "Edit", Value: "John Doe"},{Ref: "e12", Role: "button", Name: "Delete", Value: "John Doe"},- {Ref: "e13", Role: "cell", Name: "Jane Smith", Value: "[email protected]"},+ {Ref: "e13", Role: "cell", Name: "Jane Smith", Value: "[email protected]"},{Ref: "e14", Role: "button", Name: "Edit", Value: "Jane Smith"},{Ref: "e15", Role: "button", Name: "Delete", Value: "Jane Smith"},{Ref: "e16", Role: "button", Name: "Previous Page"},diff --git a/plugin/README.md b/plugin/README.mdindex c2b75e8a..0f81ac4d 100644--- a/plugin/README.md+++ b/plugin/README.md@@ -66,7 +66,7 @@ One tool definition, many actions — keeps context lean:## Agent Usage Example```-1. pinchtab({ action: "navigate", url: "https://example.com/search" })+1. pinchtab({ action: "navigate", url: "https://pinchtab.com/search" })2. pinchtab({ action: "snapshot", filter: "interactive", format: "compact" })→ Returns refs: e0, e5, e12...3. pinchtab({ action: "click", ref: "e5" })diff --git a/plugins/pinchtab/README.md b/plugins/pinchtab/README.mdindex 434efce8..95b21284 100644--- a/plugins/pinchtab/README.md+++ b/plugins/pinchtab/README.md@@ -45,11 +45,11 @@ SMCP plugin for [PinchTab](https://github.com/pinchtab/pinchtab): browser contro1. Agent calls tool **`pinchtab__navigate`** with arguments (e.g. from MCP client):```json- { "base_url": "http://localhost:9867", "instance_id": "inst_0a89a5bb", "url": "https://example.com" }+ { "base_url": "http://localhost:9867", "instance_id": "inst_0a89a5bb", "url": "https://pinchtab.com" }```2. SMCP invokes:```bash- python cli.py navigate --base-url http://localhost:9867 --instance-id inst_0a89a5bb --url https://example.com+ python cli.py navigate --base-url http://localhost:9867 --instance-id inst_0a89a5bb --url https://pinchtab.com```3. Plugin prints to stdout:```jsondiff --git a/plugins/pinchtab/tests/test_plugin_functional.py b/plugins/pinchtab/tests/test_plugin_functional.pyindex e30a8ad1..9900dc42 100644--- a/plugins/pinchtab/tests/test_plugin_functional.py+++ b/plugins/pinchtab/tests/test_plugin_functional.py@@ -52,18 +52,18 @@ def test_navigate_requires_url(base_url, token):def test_navigate_success(base_url, token):with patch("cli._api_request") as m:m.return_value = {}- result = cli.cmd_navigate({"url": "https://example.com"}, base_url, token)+ result = cli.cmd_navigate({"url": "https://pinchtab.com"}, base_url, token)assert result["status"] == "success"m.assert_called_once()body = m.call_args[1]["body"]- assert body["url"] == "https://example.com"+ assert body["url"] == "https://pinchtab.com"def test_navigate_with_options(base_url, token):with patch("cli._api_request") as m:m.return_value = {}cli.cmd_navigate({- "url": "https://example.com",+ "url": "https://pinchtab.com","block-images": True,"new-tab": True,"timeout": 60,diff --git a/plugins/pinchtab/tests/test_smcp_compat.py b/plugins/pinchtab/tests/test_smcp_compat.pyindex af818811..5f256b67 100644--- a/plugins/pinchtab/tests/test_smcp_compat.py+++ b/plugins/pinchtab/tests/test_smcp_compat.py@@ -222,7 +222,7 @@ def test_smcp_style_invoke_navigate_with_kebab_args():out, err, code = run_cli("navigate","--base-url", "http://127.0.0.1:9999",- "--url", "https://example.com",+ "--url", "https://pinchtab.com",)# Server likely unreachable -> connection_error; we only require valid JSONdata = json.loads(out)diff --git a/skill/pinchtab/SKILL.md b/skill/pinchtab/SKILL.mdindex 9000e2a5..567fabfc 100644--- a/skill/pinchtab/SKILL.md+++ b/skill/pinchtab/SKILL.md@@ -77,7 +77,7 @@ After calling `/snapshot`, you get the page's accessibility tree as JSON—flat}```-Then you act on refs: `click e0`, `type e1 "[email protected]"`, `press e2 Enter`.+Then you act on refs: `click e0`, `type e1 "[email protected]"`, `press e2 Enter`.## Core Workflow@@ -93,7 +93,7 @@ Refs (e.g. `e0`, `e5`, `e12`) are cached per tab after each snapshot — no need### Quick examples```bash-pinchtab nav https://example.com+pinchtab nav https://pinchtab.compinchtab snap -i -c # interactive + compactpinchtab click e5pinchtab type e12 hello world@@ -134,7 +134,7 @@ For the full HTTP API (curl examples, download, upload, cookies, stealth, batch```bashcurl -X POST http://localhost:9867/navigate \-H "Content-Type: application/json" \- -d '{"url": "https://example.com"}' && \+ -d '{"url": "https://pinchtab.com"}' && \sleep 3 && \curl http://localhost:9867/snapshot | jq '.nodes[] | select(.name | length > 15) | .name'```diff --git a/skill/pinchtab/references/api.md b/skill/pinchtab/references/api.mdindex f33dfa54..922ecd8b 100644--- a/skill/pinchtab/references/api.md+++ b/skill/pinchtab/references/api.md@@ -7,15 +7,15 @@ Base URL for all examples: `http://localhost:9867`## Navigate```bash-# CLI: pinchtab nav https://example.com [--new-tab] [--block-images]+# CLI: pinchtab nav https://pinchtab.com [--new-tab] [--block-images]curl -X POST /navigate \-H 'Content-Type: application/json' \- -d '{"url": "https://example.com"}'+ -d '{"url": "https://pinchtab.com"}'# With options: custom timeout, block images, open in new tabcurl -X POST /navigate \-H 'Content-Type: application/json' \- -d '{"url": "https://example.com", "timeout": 60, "blockImages": true, "newTab": true}'+ -d '{"url": "https://pinchtab.com", "timeout": 60, "blockImages": true, "newTab": true}'```## Snapshot (accessibility tree)@@ -87,7 +87,7 @@ curl -X POST /action -H 'Content-Type: application/json' \# Fill (set value directly, no keystrokes)curl -X POST /action -H 'Content-Type: application/json' \- -d '{"kind": "fill", "selector": "#email", "text": "[email protected]"}'+ -d '{"kind": "fill", "selector": "#email", "text": "[email protected]"}'# Hover (trigger dropdowns/tooltips)curl -X POST /action -H 'Content-Type: application/json' \@@ -244,7 +244,7 @@ curl /tabs# Open new tabcurl -X POST /tab -H 'Content-Type: application/json' \- -d '{"action": "new", "url": "https://example.com"}'+ -d '{"action": "new", "url": "https://pinchtab.com"}'# Close tabcurl -X POST /tab -H 'Content-Type: application/json' \@@ -275,7 +275,7 @@ curl /cookies# Set cookiescurl -X POST /cookies -H 'Content-Type: application/json' \- -d '{"url":"https://example.com","cookies":[{"name":"session","value":"abc123"}]}'+ -d '{"url":"https://pinchtab.com","cookies":[{"name":"session","value":"abc123"}]}'```## Stealthdiff --git a/tests/integration/actions_test.go b/tests/integration/actions_test.goindex af5a8c69..66c864b6 100644--- a/tests/integration/actions_test.go+++ b/tests/integration/actions_test.go@@ -53,7 +53,7 @@ func TestAction_Click_TriggersNavigation(t *testing.T) {t.Fatalf("failed to parse snapshot: %v", err)}- // Find any link (example.com has "More information..." link)+ // Find any link (pinchtab.com has "More information..." link)var linkRef stringfor _, n := range snapResp.Nodes {if n.Role == "link" {@@ -78,13 +78,13 @@ func TestAction_Click_TriggersNavigation(t *testing.T) {}// Verify navigation happened by checking the page content changed- // The "More information" link on example.com goes to iana.org+ // The "More information" link on pinchtab.com goes to iana.org_, textBody := httpGet(t, "/text?tabId="+currentTabID)text := string(textBody)- // After clicking, we should NOT be on example.com anymore+ // After clicking, we should NOT be on pinchtab.com anymoreif strings.Contains(text, "Example Domain") && !strings.Contains(text, "IANA") {- t.Errorf("click did not trigger navigation - still on example.com (bug #80: click at wrong position)")+ t.Errorf("click did not trigger navigation - still on pinchtab.com (bug #80: click at wrong position)")}t.Logf("navigation verified: page content changed after click")}diff --git a/tests/integration/navigate_test.go b/tests/integration/navigate_test.goindex 2c2c3018..e9c5f564 100644--- a/tests/integration/navigate_test.go+++ b/tests/integration/navigate_test.go@@ -86,7 +86,7 @@ func TestNavigate_Timeout(t *testing.T) {// N3: Navigate with title verificationfunc TestNavigate_SPATitle(t *testing.T) {- // Use a page that definitely has a title - example.com has "Example Domain" as title+ // Use a page that definitely has a title - pinchtab.com has "Example Domain" as title// Use retry logic for stability in CI/slow environmentscode, body := httpPostWithRetry(t, "/navigate", map[string]any{"url": examplePageURL(t)}, 2)if code != 200 {@@ -96,7 +96,7 @@ func TestNavigate_SPATitle(t *testing.T) {if title == "" {t.Error("expected non-empty title in response")}- // Verify we got the expected title from example.com+ // Verify we got the expected title from pinchtab.comif title != "Example Domain" {t.Logf("got title: %q", title)}diff --git a/tests/integration/snapshot_test.go b/tests/integration/snapshot_test.goindex f888f50e..f2c7e201 100644--- a/tests/integration/snapshot_test.go+++ b/tests/integration/snapshot_test.go@@ -46,7 +46,7 @@ func TestSnapshot_Interactive(t *testing.T) {t.Fatalf("expected 200, got %d", code)}s := string(body)- // example.com has a link "More information..."+ // pinchtab.com has a link "More information..."if !strings.Contains(s, "link") && !strings.Contains(s, "More information") {t.Log("warning: expected interactive elements in snapshot")}@@ -102,7 +102,7 @@ func TestSnapshot_MaxTokens(t *testing.T) {// S9: Snapshot with specific tabIdfunc TestSnapshot_WithTabId(t *testing.T) {- // Create first tab and navigate to example.com+ // Create first tab and navigate to pinchtab.comcode, body := httpPost(t, "/tab", map[string]string{"action": "new","url": examplePageURL(t),diff --git a/tests/integration/text_test.go b/tests/integration/text_test.goindex 7d40ad27..0e70b086 100644--- a/tests/integration/text_test.go+++ b/tests/integration/text_test.go@@ -37,7 +37,7 @@ func TestText_Raw(t *testing.T) {// T3: Text with specific tabIdfunc TestText_WithTabId(t *testing.T) {- // Create first tab and navigate to example.com+ // Create first tab and navigate to pinchtab.comcode, body := httpPost(t, "/tab", map[string]string{"action": "new","url": examplePageURL(t),