browsirai 0.1.0 → 0.2.0

package/README.md

@@ -5,7 +5,7 @@
 
 **Your browser. Your sessions. Your agent.**
 
-An MCP server that connects AI coding agents to your real Chrome via CDP. Like `httpd` or `sshd`, browsirai runs as a daemon — it survives Chrome crashes, maintains state, and is always ready.
+An MCP server + CLI that connects AI coding agents to your real Chrome via CDP. Use as an MCP server for LLM-driven automation, or as a standalone CLI for direct browser control from the terminal.
 
 ## Why browsirai?
 
@@ -170,6 +170,65 @@ mcpServers:
 ```
 </details>
 
+## CLI Mode
+
+browsirai also works as a standalone CLI — no LLM required. Same commands, same Chrome connection.
+
+```bash
+browsirai open example.com
+browsirai snapshot -i
+browsirai click @e5
+browsirai fill @e2 "hello world"
+browsirai press Enter
+browsirai eval "document.title"
+```
+
+### Commands (30)
+
+| Category | Commands |
+|----------|----------|
+| **Navigation** | `open` (goto, navigate), `back`, `scroll`, `wait`, `tab` (tabs), `close`, `resize` |
+| **Observation** | `snapshot`, `screenshot`, `html`, `eval`, `find`, `source`, `console`, `network` |
+| **Actions** | `click`, `fill`, `type`, `press` (key), `hover`, `drag`, `select`, `upload`, `dialog` |
+| **Network** | `route`, `abort`, `unroute`, `save`, `load`, `diff` |
+
+### Short Flags
+
+```bash
+browsirai snapshot -i          # interactive elements only
+browsirai snapshot -c          # compact output
+browsirai snapshot -d 3        # depth limit
+browsirai snapshot -s "main"   # scope to selector
+browsirai screenshot -o ss.png # save to file
+```
+
+### Positional Arguments
+
+```bash
+browsirai click @e5            # ref (not --ref=@e5)
+browsirai click "#submit"      # CSS selector
+browsirai fill @e2 "text"      # ref + value
+browsirai drag @e1 @e2         # source + target
+browsirai select @e3 "option1" # ref + value(s)
+browsirai scroll down           # direction
+browsirai resize 1280 720      # width height
+```
+
+### Workflow Example
+
+```bash
+browsirai open github.com/login
+browsirai snapshot -i
+# @e12 textbox "Username"
+# @e15 textbox "Password"
+# @e18 button "Sign in"
+browsirai fill @e12 "user@example.com"
+browsirai fill @e15 "password"
+browsirai click @e18
+browsirai wait --url="github.com/dashboard"
+browsirai snapshot -i
+```
+
 ## Features
 
 | Feature | Description |

package/dist/bin.js

@@ -4602,6 +4602,8 @@ __export(doctor_exports, {
 });
 import { execSync as execSync3 } from "child_process";
 import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
+import { homedir as homedir4 } from "os";
+import { join as join4 } from "path";
 function findChromePath() {
   const whichCommands = process.platform === "win32" ? ["where chrome", "where chromium", "where msedge"] : ["which google-chrome", "which chromium", "which chromium-browser", "which chrome"];
   for (const cmd of whichCommands) {
@@ -4638,41 +4640,52 @@ function checkNodeVersion() {
     message: ok ? `v${versionStr} (>= 18 required)` : `v${versionStr} \u2014 Node.js >= 18 is required`
   };
 }
-function checkPlatformConfig() {
-  const detection = detectPlatform();
-  const config = getInstallConfig(detection.platform);
-  const configPath = config.configPath;
-  if (!existsSync4(configPath)) {
-    return {
-      ok: false,
-      label: "Platform config",
-      message: `Config file not found: ${configPath} (platform: ${detection.platform})`
-    };
-  }
+function resolvePath(p) {
+  if (p.startsWith("~/")) return join4(homedir4(), p.slice(2));
+  return p;
+}
+function checkConfigFile(filePath, configKey, platform) {
+  const resolved = resolvePath(filePath);
+  if (!existsSync4(resolved)) return null;
   try {
-    const content = readFileSync4(configPath, "utf-8");
+    const content = readFileSync4(resolved, "utf-8");
     const parsed = JSON.parse(content);
-    const servers = parsed[config.configKey];
+    const servers = parsed[configKey];
     if (servers && typeof servers === "object" && "browsirai" in servers) {
       return {
         ok: true,
         label: "Platform config",
-        message: `browsirai found in ${configPath} (platform: ${detection.platform})`
+        message: `browsirai found in ${resolved} (platform: ${platform})`
       };
     }
-    return {
-      ok: false,
-      label: "Platform config",
-      message: `browsirai not found in ${configPath} under "${config.configKey}"`
-    };
+    return null;
   } catch {
-    return {
-      ok: false,
-      label: "Platform config",
-      message: `Failed to parse config file: ${configPath}`
-    };
+    return null;
   }
 }
+function checkPlatformConfig() {
+  const detection = detectPlatform();
+  const config = getInstallConfig(detection.platform);
+  const detected = checkConfigFile(config.configPath, config.configKey, detection.platform);
+  if (detected) return detected;
+  const knownPaths = [
+    { path: "~/.mcp.json", key: "mcpServers", platform: "claude-code (global)" },
+    { path: ".mcp.json", key: "mcpServers", platform: "claude-code" },
+    { path: ".cursor/mcp.json", key: "mcpServers", platform: "cursor" },
+    { path: "~/.gemini/settings.json", key: "mcpServers", platform: "gemini-cli" },
+    { path: ".vscode/mcp.json", key: "servers", platform: "vscode-copilot" },
+    { path: "~/.codeium/windsurf/mcp_config.json", key: "mcpServers", platform: "windsurf" }
+  ];
+  for (const entry of knownPaths) {
+    const result = checkConfigFile(entry.path, entry.key, entry.platform);
+    if (result) return result;
+  }
+  return {
+    ok: false,
+    label: "Platform config",
+    message: `browsirai not found in any known config file (detected: ${detection.platform})`
+  };
+}
 async function runDoctor() {
   const checks = [];
   const method = getInstallMethod();
@@ -4750,13 +4763,13 @@ __export(install_exports, {
 import { intro, select, confirm, spinner, outro, isCancel, cancel, log } from "@clack/prompts";
 import { existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync3, mkdirSync as mkdirSync4 } from "fs";
 import { resolve, dirname as dirname2 } from "path";
-import { homedir as homedir4 } from "os";
+import { homedir as homedir5 } from "os";
 function resolveConfigPath(configPath, scope) {
   if (configPath.startsWith("~")) {
-    return resolve(homedir4(), configPath.slice(2));
+    return resolve(homedir5(), configPath.slice(2));
   }
   if (scope === "global") {
-    return resolve(homedir4(), configPath);
+    return resolve(homedir5(), configPath);
   }
   return resolve(process.cwd(), configPath);
 }
@@ -4768,7 +4781,7 @@ async function runInstall() {
     const config2 = getInstallConfig(opt.value);
     const paths = [
       resolve(process.cwd(), config2.configPath),
-      config2.configPath.startsWith("~") ? resolve(homedir4(), config2.configPath.slice(2)) : resolve(homedir4(), config2.configPath)
+      config2.configPath.startsWith("~") ? resolve(homedir5(), config2.configPath.slice(2)) : resolve(homedir5(), config2.configPath)
     ];
     for (const filePath2 of paths) {
       if (existsSync5(filePath2)) {
@@ -4901,21 +4914,9 @@ async function runCli(args) {
       break;
     }
     default: {
-      console.error(`Unknown command: ${command}`);
-      console.log(
-        [
-          `browsirai v${VERSION}`,
-          "",
-          "Usage: browsirai [command]",
-          "",
-          "Commands:",
-          "  (none)      Start the MCP server (default)",
-          "  doctor      Run diagnostics",
-          "  install     Install browser integration",
-          "  --version   Print version",
-          ""
-        ].join("\n")
-      );
+      const cliUrl = new URL("./cli/run.js", import.meta.url);
+      const { runCLI } = await import(cliUrl.href);
+      await runCLI(args);
       break;
     }
   }