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 { browser } from 'wxt/browser';
import { isPanelTab, type PanelTab } from '@/lib/rail/events';
export const PANEL_COLLAPSED_KEY = 'browsentic/panelCollapsed';
export const PANEL_TAB_KEY = 'browsentic/panelTab';
export async function readPanelCollapsed(): Promise<boolean> {
const stored = await browser.storage.local.get(PANEL_COLLAPSED_KEY);
return stored[PANEL_COLLAPSED_KEY] === true;
}
/**
* Hands-free mode, while it is on. Session storage on purpose: a browser that restarts
* comes back with the panel, never with a microphone already listening.
*/
export const HANDS_FREE_KEY = 'browsentic/handsFree';
export interface HandsFreeState {
muted: boolean;
/** When it was switched on, so only the page it was switched on from plays the orb’s entrance. */
since: number;
}
export async function readHandsFree(): Promise<HandsFreeState | null> {
const stored = await browser.storage.session.get(HANDS_FREE_KEY);
const state = stored[HANDS_FREE_KEY] as HandsFreeState | undefined;
return state && typeof state.muted === 'boolean' && typeof state.since === 'number' ? state : null;
}
export function writeHandsFree(state: HandsFreeState | null): Promise<void> {
return state
? browser.storage.session.set({ [HANDS_FREE_KEY]: state })
: browser.storage.session.remove(HANDS_FREE_KEY);
}
export const PUSH_TO_TALK_KEY = 'browsentic/pushToTalk';
export const startHandsFree = (): Promise<void> => writeHandsFree({ muted: false, since: Date.now() });
export const endHandsFree = (): Promise<void> => writeHandsFree(null);
/** Picks the side panel's tab, whether the panel is open already or about to be. */
export const showPanelTab = (tab: PanelTab): Promise<void> => browser.storage.local.set({ [PANEL_TAB_KEY]: tab });
export async function readPanelTab(): Promise<PanelTab> {
const stored = await browser.storage.local.get(PANEL_TAB_KEY);
const tab = stored[PANEL_TAB_KEY];
return isPanelTab(tab) ? tab : 'chat';
}