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
/**
* Everything a person can set from either the extension's settings page or the desktop app. The
* daemon keeps it in config.json — the profile in profile.json beside it — and hands the same
* snapshot to both, after every change, whichever side made it — or a hand edit of the file.
*/
import { isThemeId, type ThemeId } from './theme';
import { isRuleEffect, type GuardrailSettings, type GuardrailValue } from './guardrails';
import { isUserProfile, type UserProfile } from './profile';
import type { PairingMode } from '@/lib/pairing';
export interface Preferences {
/** Null until someone picks one; a browser that already has a choice then hands it over. */
readonly theme: ThemeId | null;
readonly guardrails: GuardrailSettings;
readonly profile: UserProfile;
/** Shown, never changed, by the extension: the browser is what this setting guards. Absent from a Bridge before it. */
readonly pairing?: { readonly mode: PairingMode };
}
export type PreferenceChange =
| { readonly kind: 'theme'; readonly theme: ThemeId }
| { readonly kind: 'guardrail'; readonly setting: string; readonly value: GuardrailValue }
| { readonly kind: 'profile'; readonly profile: UserProfile };
export function isPreferenceChange(value: unknown): value is PreferenceChange {
if (typeof value !== 'object' || value === null) return false;
const change = value as { kind?: unknown; theme?: unknown; setting?: unknown; value?: unknown; profile?: unknown };
if (change.kind === 'theme') return isThemeId(change.theme);
if (change.kind === 'profile') return isUserProfile(change.profile);
return (
change.kind === 'guardrail' &&
typeof change.setting === 'string' &&
(change.value === null || typeof change.value === 'boolean' || isRuleEffect(change.value))
);
}