browser-cdp 0.1.0 → 0.2.1

package/README.md

@@ -12,7 +12,7 @@ npm install -g browser-cdp
 
 ```bash
 # Start browser with CDP enabled
-browser-cdp start [browser] [--profile] [--port=PORT]
+browser-cdp start [browser] [--isolated] [--port=PORT]
 
 # Navigate to URL
 browser-cdp nav <url> [--new]
@@ -38,8 +38,8 @@ browser-cdp pick '<message>'
 ## Examples
 
 ```bash
-# Start Brave with your profile
-browser-cdp start brave --profile
+# Start Brave with real profile
+browser-cdp start brave
 
 # Start Chrome on custom port
 DEBUG_PORT=9333 browser-cdp start
@@ -74,12 +74,12 @@ browser-cdp nav https://example.com
 
 ## Supported Browsers
 
-| Browser | Command | Profile Support |
-|---------|---------|-----------------|
-| Chrome | `chrome` (default) | Yes |
-| Brave | `brave` | Yes |
-| Comet | `comet` | No |
-| Edge | `edge` | Yes |
+| Browser | Command |
+|---------|---------|
+| Chrome | `chrome` (default) |
+| Brave | `brave` |
+| Comet | `comet` |
+| Edge | `edge` |
 
 ## Platform Support
 
@@ -97,7 +97,7 @@ Use `BROWSER_PATH` env var to override if your browser is installed elsewhere.
 | Aspect | browser-cdp | Playwright Test Mode |
 |--------|-------------|---------------------|
 | Browser | Your installed Chrome/Brave/etc | Bundled Chromium |
-| Profile | Can use real cookies/logins | Fresh test profile |
+| Profile | Real cookies/logins by default | Fresh test profile |
 | Detection | Not detectable as automation | Automation flags present |
 | Use case | Real-world testing, scraping | Isolated E2E tests |
 

package/cli.js

@@ -1,5 +1,12 @@
 #!/usr/bin/env node
 
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, "package.json"), "utf8"));
+
 const command = process.argv[2];
 const args = process.argv.slice(3);
 
@@ -12,12 +19,12 @@ const commands = {
 };
 
 function printUsage() {
-  console.log("browser-cdp - Browser automation via Chrome DevTools Protocol");
+  console.log(`browser-cdp v${pkg.version} - Browser automation via Chrome DevTools Protocol`);
   console.log("");
   console.log("Usage: browser-cdp <command> [options]");
   console.log("");
   console.log("Commands:");
-  console.log("  start [browser]     Start browser with CDP enabled");
+  console.log("  start [browser]     Start browser with CDP (uses real profile)");
   console.log("  nav <url>           Navigate to URL");
   console.log("  eval '<code>'       Evaluate JavaScript in page");
   console.log("  screenshot          Take screenshot of current page");
@@ -29,13 +36,18 @@ function printUsage() {
   console.log("  BROWSER_PATH        Custom browser executable path");
   console.log("");
   console.log("Examples:");
-  console.log("  browser-cdp start brave --profile");
+  console.log("  browser-cdp start brave");
   console.log("  browser-cdp nav https://google.com");
   console.log("  browser-cdp eval 'document.title'");
   console.log("  browser-cdp screenshot");
   process.exit(0);
 }
 
+if (command === "--version" || command === "-v") {
+  console.log(pkg.version);
+  process.exit(0);
+}
+
 if (!command || command === "--help" || command === "-h") {
   printUsage();
 }

package/nav.js

@@ -4,14 +4,19 @@ import { chromium } from "playwright";
 
 const DEFAULT_PORT = process.env.DEBUG_PORT || 9222;
 
-const url = process.argv[2];
+let url = process.argv[2];
 const newTab = process.argv[3] === "--new";
 
+// Add protocol if missing
+if (url && !url.match(/^https?:\/\//i)) {
+  url = "https://" + url;
+}
+
 if (!url) {
   console.log("Usage: nav.js <url> [--new]");
   console.log("\nExamples:");
-  console.log("  nav.js https://example.com       # Navigate current tab");
-  console.log("  nav.js https://example.com --new # Open in new tab");
+  console.log("  nav.js example.com       # Navigate current tab");
+  console.log("  nav.js example.com --new # Open in new tab");
   process.exit(1);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-cdp",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Browser automation via Chrome DevTools Protocol - control Chrome, Brave, Comet, Edge with real browser profiles",
   "type": "module",
   "bin": {

package/start.js

@@ -51,23 +51,23 @@ const BROWSERS = {
 const DEFAULT_PORT = 9222;
 
 function printUsage() {
-  console.log("Usage: start.js [browser] [--profile] [--port=PORT]");
+  console.log("Usage: start.js [browser] [--isolated] [--port=PORT]");
   console.log("\nBrowsers:");
   console.log("  chrome  - Google Chrome (default)");
   console.log("  brave   - Brave Browser");
   console.log("  comet   - Comet Browser");
   console.log("  edge    - Microsoft Edge");
   console.log("\nOptions:");
-  console.log("  --profile  Copy your browser profile (cookies, logins)");
-  console.log("  --port=N   Use custom debugging port (default: 9222)");
+  console.log("  --isolated  Use isolated profile (default: real profile)");
+  console.log("  --port=N    Use custom debugging port (default: 9222)");
   console.log("\nEnvironment variables:");
   console.log("  BROWSER       Default browser (chrome, brave, comet, edge)");
   console.log("  BROWSER_PATH  Custom browser executable path");
   console.log("  DEBUG_PORT    Custom debugging port");
   console.log("\nExamples:");
-  console.log("  start.js                    # Start Chrome with fresh profile");
-  console.log("  start.js brave --profile    # Start Brave with your profile");
-  console.log("  start.js comet              # Start Comet");
+  console.log("  start.js                    # Start Chrome with real profile");
+  console.log("  start.js brave              # Start Brave with real profile");
+  console.log("  start.js comet --isolated   # Start Comet with isolated profile");
   console.log("  start.js --port=9333        # Start Chrome on port 9333");
   process.exit(1);
 }
@@ -75,14 +75,14 @@ function printUsage() {
 // Parse arguments
 const args = process.argv.slice(2);
 let browserName = process.env.BROWSER || "chrome";
-let useProfile = false;
+let isolated = false;
 let port = parseInt(process.env.DEBUG_PORT) || DEFAULT_PORT;
 
 for (const arg of args) {
   if (arg === "--help" || arg === "-h") {
     printUsage();
-  } else if (arg === "--profile") {
-    useProfile = true;
+  } else if (arg === "--isolated") {
+    isolated = true;
   } else if (arg.startsWith("--port=")) {
     port = parseInt(arg.split("=")[1]);
   } else if (BROWSERS[arg]) {
@@ -137,28 +137,46 @@ try {
   }
 }
 
-// Setup profile directory
-const cacheBase = isMac
-  ? `${process.env.HOME}/Library/Caches`
-  : `${process.env.HOME}/.cache`;
-const profileDir = `${cacheBase}/browser-cdp/${browserName}`;
-execFileSync("mkdir", ["-p", profileDir], { stdio: "ignore" });
-
-if (useProfile && browserConfig.profileSource) {
-  console.log(`Syncing profile from ${browserConfig.profileSource}...`);
+// Check if browser is already running without CDP (only matters for real profile)
+if (!isolated && browserConfig.process) {
   try {
-    execFileSync("rsync", ["-a", "--delete", browserConfig.profileSource, `${profileDir}/`], {
-      stdio: "pipe",
-    });
+    const pgrepArgs = isMac
+      ? ["-x", browserConfig.process]
+      : ["-f", browserConfig.path];
+    const result = execFileSync("pgrep", pgrepArgs, { encoding: "utf8" }).trim();
+    if (result) {
+      console.error(`Error: ${browserConfig.name} is already running without CDP enabled.`);
+      console.error("");
+      console.error("When a browser is already open, launching it again just opens a new");
+      console.error("window in the existing process - the CDP flag is ignored.");
+      console.error("");
+      console.error("Options:");
+      console.error(`  1. Quit ${browserConfig.name} and run this command again`);
+      console.error(`  2. Use --isolated flag: browser-cdp start ${browserName} --isolated`);
+      console.error("     (creates separate instance, but without your cookies/logins)");
+      process.exit(1);
+    }
   } catch {
-    console.warn("Warning: Could not sync profile, using fresh profile");
+    // pgrep returns non-zero if no match - browser not running, proceed
   }
 }
 
+// Build browser arguments
+const browserArgs = [`--remote-debugging-port=${port}`];
+
+if (isolated) {
+  const cacheBase = isMac
+    ? `${process.env.HOME}/Library/Caches`
+    : `${process.env.HOME}/.cache`;
+  const profileDir = `${cacheBase}/browser-cdp/${browserName}`;
+  execFileSync("mkdir", ["-p", profileDir], { stdio: "ignore" });
+  browserArgs.push(`--user-data-dir=${profileDir}`);
+}
+
 // Start browser
-console.log(`Starting ${browserConfig.name} on port ${port}...`);
+console.log(`Starting ${browserConfig.name} on port ${port}${isolated ? " (isolated)" : ""}...`);
 
-spawn(browserPath, [`--remote-debugging-port=${port}`, `--user-data-dir=${profileDir}`], {
+spawn(browserPath, browserArgs, {
   detached: true,
   stdio: "ignore",
 }).unref();
@@ -181,6 +199,4 @@ if (!connected) {
   process.exit(1);
 }
 
-console.log(
-  `${browserConfig.name} started on :${port}${useProfile ? " with your profile" : ""}`
-);
+console.log(`${browserConfig.name} started on :${port}${isolated ? " (isolated)" : ""}`);