Skip to content

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.

1.8 KB
Raw Blame
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();
}