browsirai 0.1.1 → 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

@@ -4914,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;
     }
   }