agent-browser-loop 0.1.1 → 0.2.1

package/.claude/skills/agent-browser-loop/REFERENCE.md

@@ -16,15 +16,15 @@ agent-browser open <url> [options]
 | Flag | Description |
 |------|-------------|
 | `--headed` | Show browser window (default: headless) |
-| `--session <name>` | Named session for isolation |
-| `--viewport <WxH>` | Viewport size (default: 1280x720) |
+| `--new, -n` | Create new session with auto-generated ID |
+| `--session, -s <id>` | Target session (from `--new`) |
 | `--json` | Output as JSON |
 
 **Examples:**
 ```bash
 agent-browser open http://localhost:3000
 agent-browser open http://localhost:3000 --headed
-agent-browser open http://localhost:3000 --session test1 --viewport 1920x1080
+agent-browser open --new http://localhost:3000  # Output: Session: swift-fox
 ```
 
 ---
@@ -40,7 +40,8 @@ agent-browser act <actions...> [options]
 **Options:**
 | Flag | Description |
 |------|-------------|
-| `--session <name>` | Target session |
+| `--new, -n` | Create new session with auto-generated ID |
+| `--session, -s <id>` | Target session (from `--new`) |
 | `--no-state` | Skip state in response |
 | `--json` | Output as JSON |
 
@@ -110,7 +111,7 @@ agent-browser wait [options]
 | `--not-text <string>` | Wait for text to disappear |
 | `--not-selector <css>` | Wait for element to disappear |
 | `--timeout <ms>` | Timeout in milliseconds (default: 30000) |
-| `--session <name>` | Target session |
+| `--session, -s <id>` | Target session (from `--new`) |
 | `--json` | Output as JSON |
 
 **Examples:**
@@ -148,7 +149,7 @@ agent-browser state [options]
 **Options:**
 | Flag | Description |
 |------|-------------|
-| `--session <name>` | Target session |
+| `--session, -s <id>` | Target session (from `--new`) |
 | `--json` | Output as JSON |
 
 **Output includes:**
@@ -196,7 +197,7 @@ agent-browser screenshot [options]
 |------|-------------|
 | `--output, -o <path>` | Save to file (PNG) instead of base64 output |
 | `--full-page` | Capture full scrollable page |
-| `--session <name>` | Target session |
+| `--session, -s <id>` | Target session (from `--new`) |
 
 **Examples:**
 ```bash
@@ -214,7 +215,7 @@ agent-browser screenshot
 
 ### `close`
 
-Close browser and stop daemon.
+Close browser session or stop daemon.
 
 ```bash
 agent-browser close [options]
@@ -223,13 +224,24 @@ agent-browser close [options]
 **Options:**
 | Flag | Description |
 |------|-------------|
-| `--session <name>` | Close specific session only |
+| `--session, -s <id>` | Close specific session (daemon keeps running) |
+| `--all` | Close all sessions and stop daemon |
+
+---
+
+### `sessions`
+
+List all active browser sessions.
+
+```bash
+agent-browser sessions [--json]
+```
 
 ---
 
 ### `status`
 
-Check if daemon is running.
+Check if daemon is running and list active sessions.
 
 ```bash
 agent-browser status
@@ -304,7 +316,7 @@ These options work with most commands:
 
 | Flag | Description |
 |------|-------------|
-| `--session <name>` | Named session for isolation |
+| `--session, -s <id>` | Target session ID (from `--new`) |
 | `--json` | JSON output format |
 | `--help` | Show help |
 
@@ -360,15 +372,20 @@ agent-browser close
 
 ### Multiple Sessions
 ```bash
-# Session A: Admin user
-agent-browser open http://localhost:3000/login --session admin
-agent-browser act type:input_0:admin@test.com --session admin
+# Create sessions with auto-generated IDs
+agent-browser open --new http://localhost:3000/login  # Output: Session: swift-fox
+agent-browser open --new http://localhost:3000/login  # Output: Session: calm-river
+
+# Interact with specific sessions
+agent-browser act -s swift-fox type:input_0:admin@test.com
+agent-browser act -s calm-river type:input_0:user@test.com
+
+# List all sessions
+agent-browser sessions
 
-# Session B: Regular user  
-agent-browser open http://localhost:3000/login --session user
-agent-browser act type:input_0:user@test.com --session user
+# Close specific session (daemon keeps running)
+agent-browser close -s swift-fox
 
-# Close both
-agent-browser close --session admin
-agent-browser close --session user
+# Close all sessions and stop daemon
+agent-browser close --all
 ```

package/.claude/skills/agent-browser-loop/SKILL.md

@@ -165,10 +165,6 @@ agent-browser close
 # Headed mode (visible browser)
 agent-browser open http://localhost:3000 --headed
 
-# Named session
-agent-browser open http://localhost:3000 --session my-test
-agent-browser act click:button_0 --session my-test
-
 # JSON output
 agent-browser state --json
 
@@ -176,6 +172,20 @@ agent-browser state --json
 agent-browser act click:button_0 --no-state
 ```
 
+## Multi-Session
+
+Run multiple browsers in parallel with `--new`:
+
+```bash
+agent-browser open --new http://localhost:3000     # Output: Session: swift-fox
+agent-browser open --new http://localhost:3000     # Output: Session: calm-river
+
+agent-browser act -s swift-fox click:button_0      # Target session
+agent-browser sessions                              # List all
+agent-browser close -s swift-fox                    # Close one session
+agent-browser close --all                           # Close all, stop daemon
+```
+
 ## Screenshots
 
 ```bash

package/README.md

@@ -66,7 +66,8 @@ Every command returns the current page state - interactive elements, form values
 | `wait` | Wait for condition |
 | `state` | Get current page state |
 | `screenshot` | Capture screenshot |
-| `close` | Close browser and daemon |
+| `sessions` | List all active sessions |
+| `close` | Close session or daemon |
 | `setup` | Install browser + skill files |
 
 ### Actions
@@ -95,11 +96,29 @@ agent-browser wait --timeout 60000         # Custom timeout
 
 ```bash
 --headed              # Show browser window
---session <name>      # Named session
+--new                 # Create new session with auto-generated ID
+--session <id>        # Target specific session (from --new)
 --json                # JSON output
 --no-state            # Skip state in response
 ```
 
+## Multi-Session
+
+Run multiple browser sessions in parallel:
+
+```bash
+# Create sessions with auto-generated IDs
+agent-browser open --new http://localhost:3000     # Output: Session: swift-fox
+agent-browser open --new http://localhost:3000     # Output: Session: calm-river
+
+# Target specific sessions
+agent-browser act -s swift-fox click:button_0
+agent-browser state -s calm-river
+
+# List all sessions
+agent-browser sessions
+```
+
 ## State Output
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-browser-loop",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Let your AI coding agent drive a browser to verify its own work",
   "license": "MIT",
   "author": "Jason Silberman",

package/src/cli.ts

@@ -20,6 +20,7 @@ import {
   cleanupDaemonFiles,
   DaemonClient,
   ensureDaemon,
+  ensureDaemonNewSession,
   isDaemonRunning,
 } from "./daemon";
 import { log, withLog } from "./log";
@@ -83,12 +84,17 @@ async function loadConfig(configPath: string): Promise<BrowserCliConfig> {
 // Shared CLI Options
 // ============================================================================
 
+const newSessionFlag = flag({
+  long: "new",
+  short: "n",
+  description: "Create a new session with auto-generated ID",
+});
+
 const sessionOption = option({
   long: "session",
   short: "s",
-  type: string,
-  defaultValue: () => "default",
-  description: "Session name (default: default)",
+  type: optional(string),
+  description: "Session ID (from --new)",
 });
 
 const headlessFlag = flag({
@@ -308,6 +314,7 @@ const openCommand = command({
   args: {
     url: positional({ type: string, displayName: "url" }),
     session: sessionOption,
+    new: newSessionFlag,
     headless: headlessFlag,
     headed: headedFlag,
     config: configOption,
@@ -315,7 +322,17 @@ const openCommand = command({
   },
   handler: async (args) => {
     const browserOptions = await resolveBrowserOptions(args);
-    const client = await ensureDaemon(args.session, browserOptions);
+
+    let client: DaemonClient;
+    if (args.new) {
+      client = await ensureDaemonNewSession(browserOptions);
+    } else if (args.session) {
+      client = await ensureDaemon(args.session, browserOptions, {
+        createIfMissing: false,
+      });
+    } else {
+      client = await ensureDaemon("default", browserOptions);
+    }
 
     const response = await client.act([{ type: "navigate", url: args.url }]);
 
@@ -325,9 +342,18 @@ const openCommand = command({
     }
 
     const data = response.data as { text?: string };
+    const sessionId = client.getSessionId();
+
     if (args.json) {
-      console.log(JSON.stringify(response.data, null, 2));
+      const jsonData =
+        typeof response.data === "object" && response.data !== null
+          ? { ...(response.data as object), sessionId }
+          : { data: response.data, sessionId };
+      console.log(JSON.stringify(jsonData, null, 2));
     } else {
+      if (args.new && sessionId) {
+        console.log(`Session: ${sessionId}`);
+      }
       console.log(data.text ?? "Navigated successfully");
     }
   },
@@ -341,6 +367,7 @@ const actCommand = command({
   args: {
     actions: restPositionals({ type: string, displayName: "actions" }),
     session: sessionOption,
+    new: newSessionFlag,
     headless: headlessFlag,
     headed: headedFlag,
     config: configOption,
@@ -360,7 +387,17 @@ const actCommand = command({
     }
 
     const browserOptions = await resolveBrowserOptions(args);
-    const client = await ensureDaemon(args.session, browserOptions);
+
+    let client: DaemonClient;
+    if (args.new) {
+      client = await ensureDaemonNewSession(browserOptions);
+    } else if (args.session) {
+      client = await ensureDaemon(args.session, browserOptions, {
+        createIfMissing: false,
+      });
+    } else {
+      client = await ensureDaemon("default", browserOptions);
+    }
 
     const actions = args.actions.map(parseAction);
     const response = await client.act(actions, {
@@ -376,6 +413,9 @@ const actCommand = command({
     if (args.json) {
       console.log(JSON.stringify(response.data, null, 2));
     } else {
+      if (args.new) {
+        console.log(`Session: ${client.getSessionId()}`);
+      }
       console.log(data.text ?? "Actions completed");
     }
 
@@ -541,16 +581,20 @@ const screenshotCommand = command({
       process.exit(1);
     }
 
-    const data = response.data as { base64: string };
+    // Handle both raw string (from executeCommand) and object format
+    const base64 =
+      typeof response.data === "string"
+        ? response.data
+        : (response.data as { base64: string }).base64;
 
     if (args.output) {
       // Write to file
-      const buffer = Buffer.from(data.base64, "base64");
+      const buffer = Buffer.from(base64, "base64");
       await Bun.write(args.output, buffer);
       console.log(`Screenshot saved to ${args.output}`);
     } else {
       // Output base64
-      console.log(data.base64);
+      console.log(base64);
     }
   },
 });
@@ -558,26 +602,95 @@ const screenshotCommand = command({
 // --- close ---
 const closeCommand = command({
   name: "close",
-  description: "Close the browser and stop the daemon",
+  description: "Close the browser session or shutdown daemon",
   args: {
     session: sessionOption,
+    all: flag({
+      long: "all",
+      description: "Close all sessions and shutdown daemon",
+    }),
   },
   handler: async (args) => {
     const client = new DaemonClient(args.session);
 
     if (!(await client.ping())) {
       console.log("Daemon not running.");
-      cleanupDaemonFiles(args.session);
+      cleanupDaemonFiles();
       return;
     }
 
     try {
-      await client.shutdown();
-      console.log("Browser closed.");
+      if (args.all) {
+        await client.shutdown();
+        console.log("All sessions closed. Daemon stopped.");
+      } else {
+        const sessionId = args.session ?? "default";
+        const response = await client.closeSession(sessionId);
+        if (response.success) {
+          console.log(`Session "${sessionId}" closed.`);
+        } else {
+          console.error("Error:", response.error);
+          process.exit(1);
+        }
+      }
     } catch {
-      // Daemon may have already exited
-      cleanupDaemonFiles(args.session);
-      console.log("Browser closed.");
+      cleanupDaemonFiles();
+      console.log("Session closed.");
+    }
+  },
+});
+
+// --- sessions ---
+const sessionsCommand = command({
+  name: "sessions",
+  description: "List all active browser sessions",
+  args: {
+    json: jsonFlag,
+  },
+  handler: async (args) => {
+    const client = new DaemonClient();
+
+    if (!(await client.ping())) {
+      if (args.json) {
+        console.log(JSON.stringify({ sessions: [] }, null, 2));
+      } else {
+        console.log("Daemon not running. No active sessions.");
+      }
+      return;
+    }
+
+    const response = await client.list();
+
+    if (!response.success) {
+      console.error("Error:", response.error);
+      process.exit(1);
+    }
+
+    const data = response.data as {
+      sessions: Array<{
+        id: string;
+        url: string;
+        title: string;
+        busy: boolean;
+        lastUsed: number;
+      }>;
+    };
+
+    if (args.json) {
+      console.log(JSON.stringify(data, null, 2));
+    } else {
+      if (data.sessions.length === 0) {
+        console.log("No active sessions.");
+      } else {
+        console.log(`Sessions (${data.sessions.length}):\n`);
+        for (const s of data.sessions) {
+          const status = s.busy ? "[busy]" : "[idle]";
+          console.log(`  ${s.id} ${status}`);
+          console.log(`    ${s.title || "(no title)"}`);
+          console.log(`    ${s.url}`);
+          console.log();
+        }
+      }
     }
   },
 });
@@ -586,14 +699,40 @@ const closeCommand = command({
 const statusCommand = command({
   name: "status",
   description: "Check if daemon is running",
-  args: {
-    session: sessionOption,
-  },
-  handler: async (args) => {
-    const running = isDaemonRunning(args.session);
-    console.log(
-      `Session "${args.session}": ${running ? "running" : "not running"}`,
-    );
+  args: {},
+  handler: async () => {
+    const running = isDaemonRunning();
+    if (running) {
+      console.log("Daemon is running.");
+      // Try to list sessions
+      const client = new DaemonClient();
+      if (await client.ping()) {
+        const response = await client.list();
+        if (response.success) {
+          const data = response.data as {
+            sessions: Array<{
+              id: string;
+              url: string;
+              title: string;
+              busy: boolean;
+            }>;
+          };
+          if (data.sessions.length === 0) {
+            console.log("No active sessions.");
+          } else {
+            console.log(`\nSessions (${data.sessions.length}):`);
+            for (const s of data.sessions) {
+              const status = s.busy ? "[busy]" : "[idle]";
+              console.log(`  ${s.id} ${status}`);
+              console.log(`    ${s.title || "(no title)"}`);
+              console.log(`    ${s.url}`);
+            }
+          }
+        }
+      }
+    } else {
+      console.log("Daemon is not running.");
+    }
   },
 });
 
@@ -773,6 +912,7 @@ const cli = subcommands({
     state: stateCommand,
     screenshot: screenshotCommand,
     close: closeCommand,
+    sessions: sessionsCommand,
     status: statusCommand,
 
     // Setup & configuration