agent-browser 0.4.2 → 0.4.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -12
- package/bin/agent-browser-darwin-arm64 +0 -0
- package/bin/agent-browser-darwin-x64 +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -55,13 +55,13 @@ agent-browser find role button click --name "Submit"
|
|
|
55
55
|
### Core Commands
|
|
56
56
|
|
|
57
57
|
```bash
|
|
58
|
-
agent-browser open <url> # Navigate to URL
|
|
58
|
+
agent-browser open <url> # Navigate to URL (aliases: goto, navigate)
|
|
59
59
|
agent-browser click <sel> # Click element
|
|
60
60
|
agent-browser dblclick <sel> # Double-click element
|
|
61
61
|
agent-browser focus <sel> # Focus element
|
|
62
62
|
agent-browser type <sel> <text> # Type into element
|
|
63
63
|
agent-browser fill <sel> <text> # Clear and fill
|
|
64
|
-
agent-browser press <key> # Press key (Enter, Tab, Control+a)
|
|
64
|
+
agent-browser press <key> # Press key (Enter, Tab, Control+a) (alias: key)
|
|
65
65
|
agent-browser keydown <key> # Hold key down
|
|
66
66
|
agent-browser keyup <key> # Release key
|
|
67
67
|
agent-browser hover <sel> # Hover element
|
|
@@ -69,14 +69,14 @@ agent-browser select <sel> <val> # Select dropdown option
|
|
|
69
69
|
agent-browser check <sel> # Check checkbox
|
|
70
70
|
agent-browser uncheck <sel> # Uncheck checkbox
|
|
71
71
|
agent-browser scroll <dir> [px] # Scroll (up/down/left/right)
|
|
72
|
-
agent-browser scrollintoview <sel> # Scroll element into view
|
|
72
|
+
agent-browser scrollintoview <sel> # Scroll element into view (alias: scrollinto)
|
|
73
73
|
agent-browser drag <src> <tgt> # Drag and drop
|
|
74
74
|
agent-browser upload <sel> <files> # Upload files
|
|
75
75
|
agent-browser screenshot [path] # Take screenshot (--full for full page)
|
|
76
76
|
agent-browser pdf <path> # Save as PDF
|
|
77
77
|
agent-browser snapshot # Accessibility tree with refs (best for AI)
|
|
78
78
|
agent-browser eval <js> # Run JavaScript
|
|
79
|
-
agent-browser close # Close browser
|
|
79
|
+
agent-browser close # Close browser (aliases: quit, exit)
|
|
80
80
|
```
|
|
81
81
|
|
|
82
82
|
### Get Info
|
|
@@ -129,9 +129,9 @@ agent-browser find nth 2 "a" text
|
|
|
129
129
|
### Wait
|
|
130
130
|
|
|
131
131
|
```bash
|
|
132
|
-
agent-browser wait <selector> # Wait for element
|
|
133
|
-
agent-browser wait <ms> # Wait for time
|
|
134
|
-
agent-browser wait --text "Welcome" # Wait for text
|
|
132
|
+
agent-browser wait <selector> # Wait for element to be visible
|
|
133
|
+
agent-browser wait <ms> # Wait for time (milliseconds)
|
|
134
|
+
agent-browser wait --text "Welcome" # Wait for text to appear
|
|
135
135
|
agent-browser wait --url "**/dash" # Wait for URL pattern
|
|
136
136
|
agent-browser wait --load networkidle # Wait for load state
|
|
137
137
|
agent-browser wait --fn "window.ready === true" # Wait for JS condition
|
|
@@ -253,6 +253,10 @@ AGENT_BROWSER_SESSION=agent1 agent-browser click "#btn"
|
|
|
253
253
|
|
|
254
254
|
# List active sessions
|
|
255
255
|
agent-browser session list
|
|
256
|
+
# Output:
|
|
257
|
+
# Active sessions:
|
|
258
|
+
# -> default
|
|
259
|
+
# agent1
|
|
256
260
|
|
|
257
261
|
# Show current session
|
|
258
262
|
agent-browser session
|
|
@@ -393,15 +397,17 @@ agent-browser uses a client-daemon architecture:
|
|
|
393
397
|
|
|
394
398
|
The daemon starts automatically on first command and persists between commands for fast subsequent operations.
|
|
395
399
|
|
|
400
|
+
**Browser Engine:** Uses Chromium by default. The daemon also supports Firefox and WebKit via the Playwright protocol.
|
|
401
|
+
|
|
396
402
|
## Platforms
|
|
397
403
|
|
|
398
404
|
| Platform | Binary | Fallback |
|
|
399
405
|
|----------|--------|----------|
|
|
400
|
-
| macOS ARM64 |
|
|
401
|
-
| macOS x64 |
|
|
402
|
-
| Linux ARM64 |
|
|
403
|
-
| Linux x64 |
|
|
404
|
-
| Windows |
|
|
406
|
+
| macOS ARM64 | Native Rust | Node.js |
|
|
407
|
+
| macOS x64 | Native Rust | Node.js |
|
|
408
|
+
| Linux ARM64 | Native Rust | Node.js |
|
|
409
|
+
| Linux x64 | Native Rust | Node.js |
|
|
410
|
+
| Windows x64 | Native Rust | Node.js |
|
|
405
411
|
|
|
406
412
|
## Usage with AI Agents
|
|
407
413
|
|
|
Binary file
|
|
Binary file
|