An agentic browser harness: an AI side panel & orb in your own logged-in Chrome, Edge, Arc, Brave or even Firefox run by the agent/subscription you already use (Claude Code, Codex, Antigravity). Free, open source, no API key. Also an MCP server.
TypeScript agentic-browseragentic-browsingagy-cliaiai-agentai-browser-extensionai-toolsbrave-extensionbrowser-agentbrowser-automationbrowser-extensionbrowser-usebrowserskillchrome-extensionclaude-codecodexfirefox-addonmcp-servernanobrowserweb-automation
import { z } from 'zod';
import { ActionError, defineAction } from '../core';
import { describeElement, resolveTarget, targetSchema } from './dom';
import { keyboardInit } from './keyboard';
export const fillInput = defineAction({
name: 'page.fillInput',
description: 'Fill a text input, textarea, or contenteditable element like a user typing.',
input: z.object({
target: targetSchema.describe('Element to type into'),
value: z.string().describe('Text to enter'),
clear: z.boolean().default(true).describe('Replace existing content instead of appending'),
pressEnter: z.boolean().default(false).describe('Press Enter afterwards, which submits many forms'),
}),
execute({ target, value, clear, pressEnter }) {
const el = resolveTarget(target);
el.focus();
const { length } = typeInto(el, value, { clear, pressEnter });
return { element: describeElement(el), length, appended: !clear };
},
});
export function typeInto(
el: HTMLElement,
value: string,
{ clear, pressEnter }: { clear: boolean; pressEnter: boolean },
): { length: number; submitted: boolean } {
let next: string;
if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
next = clear ? value : el.value + value;
const proto =
el instanceof HTMLInputElement ? HTMLInputElement.prototype : HTMLTextAreaElement.prototype;
Object.getOwnPropertyDescriptor(proto, 'value')!.set!.call(el, next);
el.dispatchEvent(new InputEvent('input', { bubbles: true, data: value, inputType: 'insertText' }));
el.dispatchEvent(new Event('change', { bubbles: true }));
} else if (el.isContentEditable) {
next = clear ? value : (el.textContent ?? '') + value;
el.textContent = next;
el.dispatchEvent(new InputEvent('input', { bubbles: true, data: value, inputType: 'insertText' }));
} else {
throw new ActionError(`<${el.tagName.toLowerCase()}> is not an editable element`, 'INVALID_TARGET');
}
return { length: next.length, submitted: pressEnter ? pressEnterIn(el) : false };
}
function pressEnterIn(el: HTMLElement): boolean {
const enter = keyboardInit('Enter');
const notPrevented = el.dispatchEvent(new KeyboardEvent('keydown', enter));
el.dispatchEvent(new KeyboardEvent('keyup', enter));
const form = notPrevented && !(el instanceof HTMLTextAreaElement) ? el.closest('form') : null;
form?.requestSubmit();
return !!form;
}