oimwiodev/chrome-use
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

agent-browser

Browse Source
This commit is contained in:
Chris Tate
2026-01-10 22:51:59 -06:00
parent 6de8102978
commit 0cd29aa119
6 changed files with 194 additions and 194 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+127 -127
View File
@@ -1,6 +1,6 @@
# veb
# agent-browser
Headless browser automation CLI for agents and humans.
Headless browser automation CLI for AI agents.
## Installation
@@ -13,12 +13,12 @@ pnpm build
## Quick Start
```bash
veb open example.com
veb click "#submit"
veb fill "#email" "test@example.com"
veb get text "h1"
veb screenshot page.png
veb close
agent-browser open example.com
agent-browser click "#submit"
agent-browser fill "#email" "test@example.com"
agent-browser get text "h1"
agent-browser screenshot page.png
agent-browser close
```
## Commands
@@ -26,87 +26,87 @@ veb close
### Core Commands
```bash
veb open <url> # Navigate to URL
veb click <sel> # Click element
veb type <sel> <text> # Type into element
veb fill <sel> <text> # Clear and fill
veb press <key> # Press key (Enter, Tab, Control+a)
veb keydown <key> # Hold key down
veb keyup <key> # Release key
veb insert <text> # Insert text (no key events)
veb hover <sel> # Hover element
veb select <sel> <val> # Select dropdown option
veb multiselect <sel> <v1> <v2> # Multi-select
veb check <sel> # Check checkbox
veb uncheck <sel> # Uncheck checkbox
veb scroll <dir> [px] # Scroll (up/down/left/right)
veb scrollinto <sel> # Scroll element into view
veb drag <src> <tgt> # Drag and drop
veb upload <sel> <files> # Upload files
veb download [path] # Wait for download
veb screenshot [path] # Take screenshot (--full for full page)
veb pdf <path> # Save as PDF
veb snapshot # Accessibility tree (best for AI)
veb eval <js> # Run JavaScript
veb close # Close browser
agent-browser open <url> # Navigate to URL
agent-browser click <sel> # Click element
agent-browser type <sel> <text> # Type into element
agent-browser fill <sel> <text> # Clear and fill
agent-browser press <key> # Press key (Enter, Tab, Control+a)
agent-browser keydown <key> # Hold key down
agent-browser keyup <key> # Release key
agent-browser insert <text> # Insert text (no key events)
agent-browser hover <sel> # Hover element
agent-browser select <sel> <val> # Select dropdown option
agent-browser multiselect <sel> <v1> <v2> # Multi-select
agent-browser check <sel> # Check checkbox
agent-browser uncheck <sel> # Uncheck checkbox
agent-browser scroll <dir> [px] # Scroll (up/down/left/right)
agent-browser scrollinto <sel> # Scroll element into view
agent-browser drag <src> <tgt> # Drag and drop
agent-browser upload <sel> <files> # Upload files
agent-browser download [path] # Wait for download
agent-browser screenshot [path] # Take screenshot (--full for full page)
agent-browser pdf <path> # Save as PDF
agent-browser snapshot # Accessibility tree (best for AI)
agent-browser eval <js> # Run JavaScript
agent-browser close # Close browser
```
### Get Info
```bash
veb get text <sel> # Get text content
veb get html <sel> # Get innerHTML
veb get value <sel> # Get input value
veb get attr <sel> <attr> # Get attribute
veb get title # Get page title
veb get url # Get current URL
veb get count <sel> # Count matching elements
veb get box <sel> # Get bounding box
agent-browser get text <sel> # Get text content
agent-browser get html <sel> # Get innerHTML
agent-browser get value <sel> # Get input value
agent-browser get attr <sel> <attr> # Get attribute
agent-browser get title # Get page title
agent-browser get url # Get current URL
agent-browser get count <sel> # Count matching elements
agent-browser get box <sel> # Get bounding box
```
### Check State
```bash
veb is visible <sel> # Check if visible
veb is enabled <sel> # Check if enabled
veb is checked <sel> # Check if checked
agent-browser is visible <sel> # Check if visible
agent-browser is enabled <sel> # Check if enabled
agent-browser is checked <sel> # Check if checked
```
### Find Elements (Semantic Locators)
```bash
veb find role <role> <action> [value] # By ARIA role
veb find text <text> <action> # By text content
veb find label <label> <action> [value] # By label
veb find placeholder <ph> <action> [value] # By placeholder
veb find alt <text> <action> # By alt text
veb find title <text> <action> # By title attr
veb find testid <id> <action> [value] # By data-testid
veb find first <sel> <action> [value] # First match
veb find last <sel> <action> [value] # Last match
veb find nth <n> <sel> <action> [value] # Nth match
agent-browser find role <role> <action> [value] # By ARIA role
agent-browser find text <text> <action> # By text content
agent-browser find label <label> <action> [value] # By label
agent-browser find placeholder <ph> <action> [value] # By placeholder
agent-browser find alt <text> <action> # By alt text
agent-browser find title <text> <action> # By title attr
agent-browser find testid <id> <action> [value] # By data-testid
agent-browser find first <sel> <action> [value] # First match
agent-browser find last <sel> <action> [value] # Last match
agent-browser find nth <n> <sel> <action> [value] # Nth match
```
**Actions:** `click`, `fill`, `check`, `hover`, `text`
**Examples:**
```bash
veb find role button click --name "Submit"
veb find text "Sign In" click
veb find label "Email" fill "test@test.com"
veb find first ".item" click
veb find nth 2 "a" text
agent-browser find role button click --name "Submit"
agent-browser find text "Sign In" click
agent-browser find label "Email" fill "test@test.com"
agent-browser find first ".item" click
agent-browser find nth 2 "a" text
```
### Wait
```bash
veb wait <selector> # Wait for element
veb wait <ms> # Wait for time
veb wait --text "Welcome" # Wait for text
veb wait --url "**/dash" # Wait for URL pattern
veb wait --load networkidle # Wait for load state
veb wait --fn "window.ready === true" # Wait for JS condition
agent-browser wait <selector> # Wait for element
agent-browser wait <ms> # Wait for time
agent-browser wait --text "Welcome" # Wait for text
agent-browser wait --url "**/dash" # Wait for URL pattern
agent-browser wait --load networkidle # Wait for load state
agent-browser wait --fn "window.ready === true" # Wait for JS condition
```
**Load states:** `load`, `domcontentloaded`, `networkidle`
@@ -114,109 +114,109 @@ veb wait --fn "window.ready === true" # Wait for JS condition
### Mouse Control
```bash
veb mouse move <x> <y> # Move mouse
veb mouse down [button] # Press button (left/right/middle)
veb mouse up [button] # Release button
veb mouse wheel <dy> [dx] # Scroll wheel
agent-browser mouse move <x> <y> # Move mouse
agent-browser mouse down [button] # Press button (left/right/middle)
agent-browser mouse up [button] # Release button
agent-browser mouse wheel <dy> [dx] # Scroll wheel
```
### Browser Settings
```bash
veb set viewport <w> <h> # Set viewport size
veb set device <name> # Emulate device ("iPhone 14")
veb set geo <lat> <lng> # Set geolocation
veb set offline [on|off] # Toggle offline mode
veb set headers <json> # Extra HTTP headers
veb set credentials <u> <p> # HTTP basic auth
veb set media [dark|light|print] # Emulate media
agent-browser set viewport <w> <h> # Set viewport size
agent-browser set device <name> # Emulate device ("iPhone 14")
agent-browser set geo <lat> <lng> # Set geolocation
agent-browser set offline [on|off] # Toggle offline mode
agent-browser set headers <json> # Extra HTTP headers
agent-browser set credentials <u> <p> # HTTP basic auth
agent-browser set media [dark|light|print] # Emulate media
```
### Cookies & Storage
```bash
veb cookies # Get all cookies
veb cookies set <json> # Set cookies
veb cookies clear # Clear cookies
agent-browser cookies # Get all cookies
agent-browser cookies set <json> # Set cookies
agent-browser cookies clear # Clear cookies
veb storage local # Get all localStorage
veb storage local <key> # Get specific key
veb storage local set <k> <v> # Set value
veb storage local clear # Clear all
agent-browser storage local # Get all localStorage
agent-browser storage local <key> # Get specific key
agent-browser storage local set <k> <v> # Set value
agent-browser storage local clear # Clear all
veb storage session # Same for sessionStorage
agent-browser storage session # Same for sessionStorage
```
### Network
```bash
veb network route <url> # Intercept requests
veb network route <url> --abort # Block requests
veb network route <url> --body <json> # Mock response
veb network unroute [url] # Remove routes
veb network requests # View tracked requests
veb network requests --filter api # Filter requests
veb response <url> # Get response body (waits for matching request)
agent-browser network route <url> # Intercept requests
agent-browser network route <url> --abort # Block requests
agent-browser network route <url> --body <json> # Mock response
agent-browser network unroute [url] # Remove routes
agent-browser network requests # View tracked requests
agent-browser network requests --filter api # Filter requests
agent-browser response <url> # Get response body (waits for matching request)
```
### Tabs & Windows
```bash
veb tab # List tabs
veb tab new # New tab
veb tab <n> # Switch to tab n
veb tab close [n] # Close tab
veb window new # New window
agent-browser tab # List tabs
agent-browser tab new # New tab
agent-browser tab <n> # Switch to tab n
agent-browser tab close [n] # Close tab
agent-browser window new # New window
```
### Frames
```bash
veb frame <sel> # Switch to iframe
veb frame main # Back to main frame
agent-browser frame <sel> # Switch to iframe
agent-browser frame main # Back to main frame
```
### Dialogs
```bash
veb dialog accept [text] # Accept (with optional prompt text)
veb dialog dismiss # Dismiss
agent-browser dialog accept [text] # Accept (with optional prompt text)
agent-browser dialog dismiss # Dismiss
```
### Debug
```bash
veb trace start # Start recording trace
veb trace stop <path> # Stop and save trace
veb console # View console messages
veb console --clear # Clear console
veb errors # View page errors
veb highlight <sel> # Highlight element
veb state save <path> # Save auth state
veb state load <path> # Load auth state
veb initscript <js> # Run JS on every page load
agent-browser trace start # Start recording trace
agent-browser trace stop <path> # Stop and save trace
agent-browser console # View console messages
agent-browser console --clear # Clear console
agent-browser errors # View page errors
agent-browser highlight <sel> # Highlight element
agent-browser state save <path> # Save auth state
agent-browser state load <path> # Load auth state
agent-browser initscript <js> # Run JS on every page load
```
### Navigation
```bash
veb back # Go back
veb forward # Go forward
veb reload # Reload page
agent-browser back # Go back
agent-browser forward # Go forward
agent-browser reload # Reload page
```
### Sessions
```bash
veb session # Show current session
veb session list # List active sessions
agent-browser session # Show current session
agent-browser session list # List active sessions
```
## Options
| Option | Description |
|--------|-------------|
| `--session <name>` | Use isolated session (or `VEB_SESSION` env) |
| `--session <name>` | Use isolated session (or `AGENT_BROWSER_SESSION` env) |
| `--json` | JSON output (for agents) |
| `--full, -f` | Full page screenshot |
| `--name, -n` | Locator name filter |
@@ -229,33 +229,33 @@ Run multiple isolated browser instances:
```bash
# Different sessions
veb --session agent1 open site-a.com
veb --session agent2 open site-b.com
agent-browser --session agent1 open site-a.com
agent-browser --session agent2 open site-b.com
# Or via environment
VEB_SESSION=agent1 veb click "#btn"
AGENT_BROWSER_SESSION=agent1 agent-browser click "#btn"
# List all
veb session list
agent-browser session list
```
## Selectors
```bash
# CSS
veb click "#id"
veb click ".class"
veb click "div > button"
agent-browser click "#id"
agent-browser click ".class"
agent-browser click "div > button"
# Text
veb click "text=Submit"
agent-browser click "text=Submit"
# XPath
veb click "xpath=//button"
agent-browser click "xpath=//button"
# Semantic (recommended)
veb find role button click --name "Submit"
veb find label "Email" fill "test@test.com"
agent-browser find role button click --name "Submit"
agent-browser find label "Email" fill "test@test.com"
```
## Agent Mode
@@ -263,9 +263,9 @@ veb find label "Email" fill "test@test.com"
Use `--json` for machine-readable output:
```bash
veb snapshot --json
veb get text "h1" --json
veb is visible ".modal" --json
agent-browser snapshot --json
agent-browser get text "h1" --json
agent-browser is visible ".modal" --json
```
## License
bin/veb → bin/agent-browser
View File
package.json
+3 -3
View File
@@ -1,11 +1,11 @@
{
"name": "veb",
"name": "agent-browser",
"version": "1.0.0",
"description": "Headless browser automation CLI for agents and humans",
"description": "Headless browser automation CLI for AI agents",
"type": "module",
"main": "dist/index.js",
"bin": {
"veb": "./bin/veb"
"agent-browser": "./bin/agent-browser"
},
"scripts": {
"build": "tsc",
src/client.ts
+1 -1
View File
@@ -55,7 +55,7 @@ export async function ensureDaemon(): Promise<void> {
const child = spawn(process.execPath, [daemonPath], {
detached: true,
stdio: 'ignore',
env: { ...process.env, VEB_DAEMON: '1', VEB_SESSION: session },
env: { ...process.env, AGENT_BROWSER_DAEMON: '1', AGENT_BROWSER_SESSION: session },
});
child.unref();
src/daemon.ts
+4 -4
View File
@@ -7,7 +7,7 @@ import { parseCommand, serializeResponse, errorResponse } from './protocol.js';
import { executeCommand } from './actions.js';
// Session support - each session gets its own socket/pid
let currentSession = process.env.VEB_SESSION || 'default';
let currentSession = process.env.AGENT_BROWSER_SESSION || 'default';
/**
* Set the current session
@@ -28,7 +28,7 @@ export function getSession(): string {
*/
export function getSocketPath(session?: string): string {
const sess = session ?? currentSession;
return path.join(os.tmpdir(), `veb-${sess}.sock`);
return path.join(os.tmpdir(), `agent-browser-${sess}.sock`);
}
/**
@@ -36,7 +36,7 @@ export function getSocketPath(session?: string): string {
*/
export function getPidFile(session?: string): string {
const sess = session ?? currentSession;
return path.join(os.tmpdir(), `veb-${sess}.pid`);
return path.join(os.tmpdir(), `agent-browser-${sess}.pid`);
}
/**
@@ -178,7 +178,7 @@ export async function startDaemon(): Promise<void> {
}
// Run daemon if this is the entry point
if (process.argv[1]?.endsWith('daemon.js') || process.env.VEB_DAEMON === '1') {
if (process.argv[1]?.endsWith('daemon.js') || process.env.AGENT_BROWSER_DAEMON === '1') {
startDaemon().catch((err) => {
console.error('Daemon error:', err);
cleanupSocket();
src/index.ts
+59 -59
View File
@@ -15,7 +15,7 @@ function listSessions(): string[] {
const files = fs.readdirSync(tmpDir);
const sessions: string[] = [];
for (const file of files) {
const match = file.match(/^veb-(.+)\.pid$/);
const match = file.match(/^agent-browser-(.+)\.pid$/);
if (match) {
const pidFile = path.join(tmpDir, file);
try {
@@ -60,9 +60,9 @@ function err(msg: string): never {
function printHelp(): void {
console.log(`
${c('bold', 'veb')} - headless browser automation
${c('bold', 'agent-browser')} - headless browser automation for AI agents
${c('yellow', 'Usage:')} veb <command> [options]
${c('yellow', 'Usage:')} agent-browser <command> [options]
${c('yellow', 'Core Commands:')}
${c('cyan', 'open')} <url> Navigate to URL
@@ -79,26 +79,26 @@ ${c('yellow', 'Core Commands:')}
${c('cyan', 'eval')} <js> Run JavaScript
${c('cyan', 'close')} Close browser
${c('yellow', 'Get Info:')} veb get <what> [selector]
${c('yellow', 'Get Info:')} agent-browser get <what> [selector]
text, html, value, attr, title, url, count, box
${c('yellow', 'Check State:')} veb is <what> <selector>
${c('yellow', 'Check State:')} agent-browser is <what> <selector>
visible, enabled, checked
${c('yellow', 'Find Elements:')} veb find <locator> <action> [value]
${c('yellow', 'Find Elements:')} agent-browser find <locator> <action> [value]
role, text, label, placeholder, alt, title, testid, first, last, nth
${c('yellow', 'Mouse:')} veb mouse <action> [args]
${c('yellow', 'Mouse:')} agent-browser mouse <action> [args]
move <x> <y>, down, up, wheel <dy>
${c('yellow', 'Storage:')}
${c('cyan', 'cookies')} [get|set|clear] Manage cookies
${c('cyan', 'storage')} <local|session> Manage web storage
${c('yellow', 'Browser:')} veb set <setting> [value]
${c('yellow', 'Browser:')} agent-browser set <setting> [value]
viewport, device, geo, offline, headers, credentials
${c('yellow', 'Network:')} veb network <action>
${c('yellow', 'Network:')} agent-browser network <action>
route, unroute, requests
${c('yellow', 'Tabs:')}
@@ -110,21 +110,21 @@ ${c('yellow', 'Debug:')}
${c('cyan', 'errors')} View page errors
${c('yellow', 'Options:')}
--session <name> Isolated session (or VEB_SESSION env)
--session <name> Isolated session (or AGENT_BROWSER_SESSION env)
--json JSON output
--full, -f Full page screenshot
--headed Show browser window (not headless)
--debug Debug output
${c('yellow', 'Examples:')}
veb open example.com
veb click "#submit"
veb fill "#email" "test@example.com"
veb get text "h1"
veb is visible ".modal"
veb find role button click --name Submit
veb wait 2000
veb wait --load networkidle
agent-browser open example.com
agent-browser click "#submit"
agent-browser fill "#email" "test@example.com"
agent-browser get text "h1"
agent-browser is visible ".modal"
agent-browser find role button click --name Submit
agent-browser wait 2000
agent-browser wait --load networkidle
`);
}
@@ -267,29 +267,29 @@ async function handleGet(args: string[], id: string): Promise<Record<string, unk
switch (what) {
case 'text':
if (!selector) err('Selector required: veb get text <selector>');
if (!selector) err('Selector required: agent-browser get text <selector>');
return { id, action: 'gettext', selector };
case 'html':
if (!selector) err('Selector required: veb get html <selector>');
if (!selector) err('Selector required: agent-browser get html <selector>');
return { id, action: 'innerhtml', selector };
case 'value':
if (!selector) err('Selector required: veb get value <selector>');
if (!selector) err('Selector required: agent-browser get value <selector>');
return { id, action: 'inputvalue', selector };
case 'attr':
if (!selector || !args[2]) err('Usage: veb get attr <selector> <attribute>');
if (!selector || !args[2]) err('Usage: agent-browser get attr <selector> <attribute>');
return { id, action: 'getattribute', selector, attribute: args[2] };
case 'title':
return { id, action: 'title' };
case 'url':
return { id, action: 'url' };
case 'count':
if (!selector) err('Selector required: veb get count <selector>');
if (!selector) err('Selector required: agent-browser get count <selector>');
return { id, action: 'count', selector };
case 'box':
if (!selector) err('Selector required: veb get box <selector>');
if (!selector) err('Selector required: agent-browser get box <selector>');
return { id, action: 'boundingbox', selector };
default:
err(`Unknown: veb get ${what}. Options: text, html, value, attr, title, url, count, box`);
err(`Unknown: agent-browser get ${what}. Options: text, html, value, attr, title, url, count, box`);
}
}
@@ -297,7 +297,7 @@ async function handleIs(args: string[], id: string): Promise<Record<string, unkn
const what = args[0];
const selector = args[1];
if (!selector) err(`Selector required: veb is ${what} <selector>`);
if (!selector) err(`Selector required: agent-browser is ${what} <selector>`);
switch (what) {
case 'visible':
@@ -307,7 +307,7 @@ async function handleIs(args: string[], id: string): Promise<Record<string, unkn
case 'checked':
return { id, action: 'ischecked', selector };
default:
err(`Unknown: veb is ${what}. Options: visible, enabled, checked`);
err(`Unknown: agent-browser is ${what}. Options: visible, enabled, checked`);
}
}
@@ -321,7 +321,7 @@ async function handleFind(
const subaction = args[2] || 'click';
const fillValue = args[3];
if (!value) err(`Value required: veb find ${locator} <value> <action>`);
if (!value) err(`Value required: agent-browser find ${locator} <value> <action>`);
const exact = flags.exact;
const name = flags.name;
@@ -357,7 +357,7 @@ async function handleFind(
const sel = args[2];
const act = args[3] || 'click';
const val = args[4];
if (isNaN(idx) || !sel) err('Usage: veb find nth <index> <selector> <action>');
if (isNaN(idx) || !sel) err('Usage: agent-browser find nth <index> <selector> <action>');
return { id, action: 'nth', selector: sel, index: idx, subaction: act, value: val };
}
default:
@@ -374,7 +374,7 @@ async function handleMouse(args: string[], id: string): Promise<Record<string, u
case 'move': {
const x = parseInt(args[1], 10);
const y = parseInt(args[2], 10);
if (isNaN(x) || isNaN(y)) err('Usage: veb mouse move <x> <y>');
if (isNaN(x) || isNaN(y)) err('Usage: agent-browser mouse move <x> <y>');
return { id, action: 'mousemove', x, y };
}
case 'down':
@@ -387,7 +387,7 @@ async function handleMouse(args: string[], id: string): Promise<Record<string, u
return { id, action: 'wheel', deltaY: dy, deltaX: dx };
}
default:
err(`Unknown: veb mouse ${action}. Options: move, down, up, wheel`);
err(`Unknown: agent-browser mouse ${action}. Options: move, down, up, wheel`);
}
}
@@ -398,23 +398,23 @@ async function handleSet(args: string[], id: string): Promise<Record<string, unk
case 'viewport': {
const w = parseInt(args[1], 10);
const h = parseInt(args[2], 10);
if (isNaN(w) || isNaN(h)) err('Usage: veb set viewport <width> <height>');
if (isNaN(w) || isNaN(h)) err('Usage: agent-browser set viewport <width> <height>');
return { id, action: 'viewport', width: w, height: h };
}
case 'device':
if (!args[1]) err('Usage: veb set device <name>');
if (!args[1]) err('Usage: agent-browser set device <name>');
return { id, action: 'device', device: args[1] };
case 'geo':
case 'geolocation': {
const lat = parseFloat(args[1]);
const lng = parseFloat(args[2]);
if (isNaN(lat) || isNaN(lng)) err('Usage: veb set geo <lat> <lng>');
if (isNaN(lat) || isNaN(lng)) err('Usage: agent-browser set geo <lat> <lng>');
return { id, action: 'geolocation', latitude: lat, longitude: lng };
}
case 'offline':
return { id, action: 'offline', offline: args[1] !== 'off' && args[1] !== 'false' };
case 'headers':
if (!args[1]) err('Usage: veb set headers <json>');
if (!args[1]) err('Usage: agent-browser set headers <json>');
try {
return { id, action: 'headers', headers: JSON.parse(args[1]) };
} catch {
@@ -423,7 +423,7 @@ async function handleSet(args: string[], id: string): Promise<Record<string, unk
break;
case 'credentials':
case 'auth':
if (!args[1] || !args[2]) err('Usage: veb set credentials <user> <pass>');
if (!args[1] || !args[2]) err('Usage: agent-browser set credentials <user> <pass>');
return { id, action: 'credentials', username: args[1], password: args[2] };
case 'media': {
const colorScheme = args.includes('dark')
@@ -440,7 +440,7 @@ async function handleSet(args: string[], id: string): Promise<Record<string, unk
}
default:
err(
`Unknown: veb set ${setting}. Options: viewport, device, geo, offline, headers, credentials, media`
`Unknown: agent-browser set ${setting}. Options: viewport, device, geo, offline, headers, credentials, media`
);
}
return {};
@@ -456,7 +456,7 @@ async function handleNetwork(
switch (action) {
case 'route': {
const url = args[1];
if (!url) err('Usage: veb network route <url> [--abort|--body <json>]');
if (!url) err('Usage: agent-browser network route <url> [--abort|--body <json>]');
const abort = allArgs.includes('--abort');
const bodyIdx = allArgs.indexOf('--body');
const body = bodyIdx !== -1 ? allArgs[bodyIdx + 1] : undefined;
@@ -477,7 +477,7 @@ async function handleNetwork(
return { id, action: 'requests', clear, filter };
}
default:
err(`Unknown: veb network ${action}. Options: route, unroute, requests`);
err(`Unknown: agent-browser network ${action}. Options: route, unroute, requests`);
}
return {};
}
@@ -487,11 +487,11 @@ async function handleStorage(args: string[], id: string): Promise<Record<string,
const sub = args[1];
if (type !== 'local' && type !== 'session') {
err('Usage: veb storage <local|session> [get|set|clear] [key] [value]');
err('Usage: agent-browser storage <local|session> [get|set|clear] [key] [value]');
}
if (sub === 'set') {
if (!args[2] || !args[3]) err(`Usage: veb storage ${type} set <key> <value>`);
if (!args[2] || !args[3]) err(`Usage: agent-browser storage ${type} set <key> <value>`);
return { id, action: 'storage_set', type, key: args[2], value: args[3] };
} else if (sub === 'clear') {
return { id, action: 'storage_clear', type };
@@ -505,7 +505,7 @@ async function handleCookies(args: string[], id: string): Promise<Record<string,
const sub = args[0];
if (sub === 'set') {
if (!args[1]) err('Usage: veb cookies set <json>');
if (!args[1]) err('Usage: agent-browser cookies set <json>');
try {
return { id, action: 'cookies_set', cookies: JSON.parse(args[1]) };
} catch {
@@ -531,7 +531,7 @@ async function handleTab(args: string[], id: string): Promise<Record<string, unk
return { id, action: 'tab_close', index: idx };
} else {
const idx = parseInt(sub, 10);
if (isNaN(idx)) err(`Unknown: veb tab ${sub}. Options: new, list, close, <index>`);
if (isNaN(idx)) err(`Unknown: agent-browser tab ${sub}. Options: new, list, close, <index>`);
return { id, action: 'tab_switch', index: idx };
}
}
@@ -542,10 +542,10 @@ async function handleTrace(args: string[], id: string): Promise<Record<string, u
if (sub === 'start') {
return { id, action: 'trace_start', screenshots: true, snapshots: true };
} else if (sub === 'stop') {
if (!args[1]) err('Usage: veb trace stop <path>');
if (!args[1]) err('Usage: agent-browser trace stop <path>');
return { id, action: 'trace_stop', path: args[1] };
} else {
err('Usage: veb trace start|stop');
err('Usage: agent-browser trace start|stop');
}
return {};
}
@@ -555,13 +555,13 @@ async function handleState(args: string[], id: string): Promise<Record<string, u
const path = args[1];
if (sub === 'save') {
if (!path) err('Usage: veb state save <path>');
if (!path) err('Usage: agent-browser state save <path>');
return { id, action: 'state_save', path };
} else if (sub === 'load') {
if (!path) err('Usage: veb state load <path>');
if (!path) err('Usage: agent-browser state load <path>');
return { id, action: 'state_load', path };
} else {
err('Usage: veb state save|load <path>');
err('Usage: agent-browser state save|load <path>');
}
return {};
}
@@ -592,7 +592,7 @@ function parseFlags(args: string[]): { flags: Flags; cleanArgs: string[] } {
text: false,
debug: false,
headed: false,
session: process.env.VEB_SESSION || 'default',
session: process.env.AGENT_BROWSER_SESSION || 'default',
exact: false,
};
@@ -683,12 +683,12 @@ async function main(): Promise<void> {
break;
case 'type':
if (!args[0] || !args[1]) err('Usage: veb type <selector> <text>');
if (!args[0] || !args[1]) err('Usage: agent-browser type <selector> <text>');
cmd = { id, action: 'type', selector: args[0], text: args.slice(1).join(' ') };
break;
case 'fill':
if (!args[0] || !args[1]) err('Usage: veb fill <selector> <text>');
if (!args[0] || !args[1]) err('Usage: agent-browser fill <selector> <text>');
cmd = { id, action: 'fill', selector: args[0], value: args.slice(1).join(' ') };
break;
@@ -729,17 +729,17 @@ async function main(): Promise<void> {
break;
case 'select':
if (!args[0] || !args[1]) err('Usage: veb select <selector> <value>');
if (!args[0] || !args[1]) err('Usage: agent-browser select <selector> <value>');
cmd = { id, action: 'select', selector: args[0], value: args[1] };
break;
case 'drag':
if (!args[0] || !args[1]) err('Usage: veb drag <source> <target>');
if (!args[0] || !args[1]) err('Usage: agent-browser drag <source> <target>');
cmd = { id, action: 'drag', source: args[0], target: args[1] };
break;
case 'upload':
if (!args[0] || !args[1]) err('Usage: veb upload <selector> <files...>');
if (!args[0] || !args[1]) err('Usage: agent-browser upload <selector> <files...>');
cmd = { id, action: 'upload', selector: args[0], files: args.slice(1) };
break;
@@ -767,7 +767,7 @@ async function main(): Promise<void> {
} else if (target) {
cmd = { id, action: 'wait', selector: target };
} else {
err('Usage: veb wait <selector|ms|--text|--url|--load|--fn>');
err('Usage: agent-browser wait <selector|ms|--text|--url|--load|--fn>');
}
break;
}
@@ -852,7 +852,7 @@ async function main(): Promise<void> {
if (args[0] === 'new') {
cmd = { id, action: 'window_new' };
} else {
err('Usage: veb window new');
err('Usage: agent-browser window new');
}
break;
@@ -871,7 +871,7 @@ async function main(): Promise<void> {
} else if (args[0] === 'dismiss') {
cmd = { id, action: 'dialog', response: 'dismiss' };
} else {
err('Usage: veb dialog accept|dismiss');
err('Usage: agent-browser dialog accept|dismiss');
}
break;
@@ -915,7 +915,7 @@ async function main(): Promise<void> {
case 'multiselect':
if (!args[0] || args.length < 2)
err('Usage: veb multiselect <selector> <value1> [value2...]');
err('Usage: agent-browser multiselect <selector> <value1> [value2...]');
cmd = { id, action: 'multiselect', selector: args[0], values: args.slice(1) };
break;
@@ -962,7 +962,7 @@ async function main(): Promise<void> {
default:
console.error(c('red', 'Unknown command:'), command);
console.error(c('dim', 'Run: veb --help'));
console.error(c('dim', 'Run: agent-browser --help'));
process.exit(1);
}