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 { useCallback, useEffect, useState } from 'react';
import { browser } from 'wxt/browser';
import { BRIDGE_CHANNEL, type ActionResult } from '@/lib/actions/protocol';
import type { PreferenceChange, Preferences } from '@/lib/settings/preferences';
import { useDaemonState } from './use-daemon-state';
type PreferenceRequest = { op: 'preferences' } | { op: 'setPreference'; change: PreferenceChange };
export function usePreferences() {
const daemon = useDaemonState();
const connected = daemon?.connected ?? false;
const preferences = daemon?.preferences;
const [busy, setBusy] = useState<string | null>(null);
const [error, setError] = useState<string | null>(null);
const ask = useCallback(async (request: PreferenceRequest, marker: string) => {
setBusy(marker);
setError(null);
const result = (await browser.runtime
.sendMessage({ channel: BRIDGE_CHANNEL, ...request })
.catch(() => null)) as ActionResult<Preferences> | null;
setBusy(null);
if (!result?.ok) setError(result?.error.message ?? 'The daemon did not answer.');
return result?.ok === true;
}, []);
useEffect(() => {
if (connected && !preferences) void ask({ op: 'preferences' }, 'load');
}, [connected, preferences, ask]);
const reload = useCallback(() => ask({ op: 'preferences' }, 'load'), [ask]);
const change = useCallback((next: PreferenceChange, marker: string) => ask({ op: 'setPreference', change: next }, marker), [ask]);
return { paired: daemon?.paired ?? false, connected, preferences, busy, error, reload, change };
}