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
type SidebarAction = { open: () => Promise<void>; close: () => Promise<void>; toggle: () => Promise<void> };
export const LAUNCHER_PAGE = 'launcher.html';
function sidebarAction(): SidebarAction {
return (browser as unknown as { sidebarAction: SidebarAction }).sidebarAction;
}
/** Some Chromium browsers have no side panel, and their toolbar button opens the launcher instead. */
export const hasSidePanel = (): boolean => import.meta.env.FIREFOX || typeof browser.sidePanel?.open === 'function';
export function openSidePanel(windowId: number) {
if (import.meta.env.FIREFOX) return sidebarAction().open();
return browser.sidePanel.open({ windowId });
}
/** Firefox lets the background shut the sidebar, as long as a user gesture is still live. */
export function closeSidebar(): Promise<void> {
return sidebarAction().close();
}
export function toggleSidebar(): Promise<void> {
return sidebarAction().toggle();
}
/** A Chromium browser with no side panel keeps the launcher popup on its toolbar button instead. */
export async function openPanelFromToolbar(): Promise<void> {
try {
await browser.sidePanel.setPanelBehavior({ openPanelOnActionClick: true });
} catch {
await browser.action.setPopup({ popup: LAUNCHER_PAGE });
}
}
/** Only the panel itself calls this, so `window.close()` is the fallback worth having. */
export async function closeSidePanel(windowId: number | null): Promise<void> {
try {
if (import.meta.env.FIREFOX) {
await sidebarAction().close();
return;
}
const api = browser.sidePanel as unknown as {
close?: (options: { windowId: number }) => Promise<void>;
};
if (api.close && windowId != null) {
await api.close({ windowId });
return;
}
} catch {
/* falls through to closing the page */
}
if (typeof window !== 'undefined') window.close();
}