Browser Tool

npm install -g agent-browser
agent-browser install  # Downloads Chrome

// Open a URL
browser({ action: 'open', url: 'https://example.com' });
 
// Close browser
browser({ action: 'close' });
 
// Navigate to new tab
browser({ action: 'tab', text: 'new', url: 'https://example.com' });

// Click an element
browser({ action: 'click', selector: '@e2' });
 
// Double-click
browser({ action: 'dblclick', selector: '@e2' });
 
// Hover
browser({ action: 'hover', selector: '@e2' });
 
// Fill input (clears then types)
browser({ action: 'fill', selector: '@e2', text: 'user@example.com' });
 
// Type (appends)
browser({ action: 'type', selector: '@e2', text: ' more text' });
 
// Press key
browser({ action: 'press', key: 'Enter' });

// Get accessibility tree with interactive elements
browser({ action: 'snapshot', flags: JSON.stringify({ interactive: true }) });
 
// Take screenshot
browser({ action: 'screenshot', outputPath: '/path/to/screenshot.png' });
 
// Full page screenshot
browser({
  action: 'screenshot',
  outputPath: '/path/to/full.png',
  flags: JSON.stringify({ full: true }),
});
 
// Get page title
browser({ action: 'get', text: 'title' });
 
// Get current URL
browser({ action: 'get', text: 'url' });
 
// Get element text
browser({ action: 'get', selector: '@e1', text: 'text' });
 
// Check if visible
browser({ action: 'is', text: 'visible', selector: '@e1' });

// Wait for URL pattern
browser({ action: 'wait', text: '**/dashboard' });
 
// Wait for text
browser({ action: 'wait', text: 'Welcome' });
 
// Wait for network idle
browser({ action: 'wait', text: 'networkidle' });
 
// Wait for selector
browser({ action: 'wait', selector: '@e1' });

browser({
  action: 'batch',
  commands: [
    'open https://example.com',
    'wait --load networkidle',
    'fill @e1 user@example.com',
    'fill @e2 password',
    'click @e3',
    'wait --url **/dashboard',
  ],
});

// Create session
browser({ action: 'open', url: 'https://app.example.com', session: 'myapp' });
 
// Continue in same session
browser({ action: 'click', selector: '@e1', session: 'myapp' });