browsirai 0.1.1 → 0.2.1

package/README.md

@@ -1,11 +1,11 @@
 # browsirai
 
 [![npm version](https://img.shields.io/npm/v/browsirai.svg?style=flat-square)](https://www.npmjs.com/package/browsirai)
-[![License: BSL-1.1](https://img.shields.io/badge/license-BSL--1.1-blue?style=flat-square)](LICENSE)
+[![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue?style=flat-square)](LICENSE)
 
 **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?
 
@@ -21,14 +21,69 @@ An MCP server that connects AI coding agents to your real Chrome via CDP. Like `
 
 - **Always up to date** — Auto-upgrade checks npm registry on every server start. Next session launches with the latest version. Zero manual intervention.
 
+## Demos
+
+<table>
+<tr>
+<td width="50%">
+
+**"show me my GitHub repos with star counts"**
+
+Your GitHub session is already there. No API tokens, no OAuth.
+
+https://github.com/user-attachments/assets/980a60c7-36c7-47f5-9598-dcc351ba93cf
+
+</td>
+<td width="50%">
+
+**"block my calendar tonight 7-8pm for dinner"**
+
+No Google OAuth registration. No Calendar API credentials. Your browser is already authenticated.
+
+https://github.com/user-attachments/assets/51574049-b02c-4821-a0d0-d2ede9115c26
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+**"what am I working on right now?"**
+
+Reads your open tabs — the highest-signal context source no other agent can access.
+
+https://github.com/user-attachments/assets/4e61fede-bee6-4749-b26f-5eaf79e182f3
+
+</td>
+<td width="50%">
+
+**"check this repo for console errors and network requests"**
+
+Structured CDP data. ~500 tokens via snapshot vs ~10K via screenshot. 20x cheaper.
+
+https://github.com/user-attachments/assets/95e4643f-d6f6-4315-85f4-cf0774128192
+
+</td>
+</tr>
+<tr>
+<td colspan="2">
+
+**"which component renders this button? give me the source file."**
+
+Walks the React Fiber tree at runtime via CDP. No source maps, no devtools extension. React, Vue, Svelte.
+
+https://github.com/user-attachments/assets/e3370a69-a3ae-450b-bf2c-786e58ce27db
+
+</td>
+</tr>
+</table>
+
 ## Quick Start
 
 ```bash
-npm install -g browsirai
-browsirai install
+npx browsirai install
 ```
 
-The installer auto-detects your AI platform and configures the MCP server.
+Auto-detects your AI platform and configures the MCP server. No global install needed.
 
 <details>
 <summary><strong>Claude Code</strong></summary>
@@ -170,6 +225,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 |
@@ -451,4 +565,4 @@ Yes — the LLM sees the same content you'd see in the browser. This is inherent
 
 ## License
 
-BSL-1.1 (Business Source License 1.1) — free for non-commercial use. Converts to Apache-2.0 on March 14, 2030.
+AGPL-3.0 — free to use, modify, and distribute. If you modify and deploy as a network service, you must open-source your changes.

package/dist/bin.js

@@ -458,7 +458,8 @@ async function launchChromeWithDebugging(port = 9222, headless = false) {
   }
   const args = [
     `--remote-debugging-port=${targetPort}`,
-    "--remote-allow-origins=*"
+    "--remote-allow-origins=*",
+    "--no-sandbox"
   ];
   if (dataDir) {
     args.push(`--user-data-dir=${dataDir}`, "--no-first-run", "--no-default-browser-check", "--disable-extensions");
@@ -572,7 +573,8 @@ async function launchHeadlessChrome() {
     "--no-first-run",
     "--no-default-browser-check",
     "--disable-extensions",
-    "--disable-gpu"
+    "--disable-gpu",
+    "--no-sandbox"
   ], {
     detached: true,
     stdio: "ignore"
@@ -4914,21 +4916,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;
     }
   }