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.9 KB
Raw Blame
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';
}