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
export const AGENT_KINDS = ['claude', 'codex', 'antigravity', 'vibe', 'grok', 'cursor', 'qwen', 'opencode', 'deepseek'] as const;
export type AgentKind = (typeof AGENT_KINDS)[number];
export const DEFAULT_AGENT: AgentKind = 'claude';
export interface AgentDescriptor {
kind: AgentKind;
label: string;
vendor: string;
bin: string;
install: string;
docs: string;
/** Model ids the picker offers, strongest first, whenever the CLI cannot list its own. */
models: string[];
/** Shipped before a whole conversation was run against the real CLI; the picker and the docs say so. */
beta?: boolean;
}
export const AGENTS: Record<AgentKind, AgentDescriptor> = {
claude: {
kind: 'claude',
label: 'Claude Code',
vendor: 'Anthropic',
bin: 'claude',
install: 'npm i -g @anthropic-ai/claude-code',
docs: 'https://claude.com/claude-code',
// Claude Code resolves each alias to the newest model of that family, so this list does not age.
models: ['fable', 'opus', 'sonnet', 'haiku'],
},
codex: {
kind: 'codex',
label: 'Codex',
vendor: 'OpenAI',
bin: 'codex',
install: 'npm i -g @openai/codex',
docs: 'https://developers.openai.com/codex/cli',
models: ['gpt-5.6-terra', 'gpt-5.6-luna', 'gpt-5.5'],
},
antigravity: {
kind: 'antigravity',
label: 'Antigravity',
vendor: 'Google',
bin: 'agy',
install: 'https://antigravity.google/docs/cli/install',
docs: 'https://antigravity.google/docs/cli',
models: ['gemini-3.1-pro-high', 'gemini-3.8-flash-high', 'gemini-3.8-flash-medium'],
},
vibe: {
kind: 'vibe',
label: 'Mistral Vibe',
vendor: 'Mistral AI',
bin: 'vibe',
install: 'uv tool install mistral-vibe',
docs: 'https://github.com/mistralai/mistral-vibe',
models: ['mistral-medium-3.5'],
beta: true,
},
grok: {
kind: 'grok',
label: 'Grok Build',
vendor: 'xAI',
bin: 'grok',
install: 'curl -fsSL https://x.ai/cli/install.sh | bash',
docs: 'https://docs.x.ai/build/overview',
models: ['grok-4.7'],
beta: true,
},
cursor: {
kind: 'cursor',
label: 'Cursor CLI',
vendor: 'Anysphere',
bin: 'cursor-agent',
install: 'curl https://cursor.com/install -fsS | bash',
docs: 'https://cursor.com/docs/cli/overview',
models: ['auto', 'composer-2.5', 'claude-opus-5-thinking-high', 'gpt-5.3-codex'],
beta: true,
},
qwen: {
kind: 'qwen',
label: 'Qwen Code',
vendor: 'Alibaba',
bin: 'qwen',
install: 'npm i -g @qwen-code/qwen-code',
docs: 'https://qwenlm.github.io/qwen-code-docs/en/',
// Which of these an account can reach depends on the provider it is pointed at, and no
// subcommand lists them, so these are curated.
models: ['qwen3-coder-plus', 'qwen3.7-plus', 'qwen3.6-plus', 'qwen3-max-2026-01-23'],
beta: true,
},
opencode: {
kind: 'opencode',
label: 'OpenCode',
vendor: 'Anomaly',
bin: 'opencode',
install: 'npm i -g opencode-ai',
docs: 'https://opencode.ai/docs/cli/',
// Spelled provider/model, and reachable only through a provider OpenCode is signed in to: Zen's
// free models refuse a run whose tools are narrowed to the browser.
models: ['anthropic/claude-opus-5-5', 'anthropic/claude-sonnet-5', 'openai/gpt-5.6', 'google/gemini-3.1-pro-preview'],
beta: true,
},
deepseek: {
kind: 'deepseek',
label: 'DeepSeek Harness',
vendor: 'DeepSeek',
bin: 'dsh',
install: 'npm i -g @deepseek-ai/dsh',
docs: 'https://deepseek-harness.github.io/deepseek-harness/',
// The same ids on a DeepSeek account and on an API key. Only deepseek-flash reads a screenshot.
models: ['deepseek-flash', 'deepseek-v4-pro'],
beta: true,
},
};
export const AGENT_LIST: AgentDescriptor[] = AGENT_KINDS.map((kind) => AGENTS[kind]);
export function isAgentKind(value: unknown): value is AgentKind {
return typeof value === 'string' && (AGENT_KINDS as readonly string[]).includes(value);
}
/** An agent's name, or its kind as sent when it came after this build: a newer Bridge can run one. */
export function agentLabel(kind: AgentKind): string {
return isAgentKind(kind) ? AGENTS[kind].label : String(kind);
}
/** What a panel too old to know the chosen agent is told instead of being sent it. */
export function needsNewerExtension(kind: AgentKind): string {
return `${agentLabel(kind)} needs a newer Browsentic extension. Update it, or pick another agent with \`browsentic agent claude\`.`;
}
export interface AgentProblem {
code: 'AGENT_MISSING' | 'AGENT_UNUSABLE' | 'AGENT_NEEDS_PERMISSION';
message: string;
/** What the user can do about it — a shell command, a URL, or a line of config. */
fix?: string;
/** The daemon can repair this itself if the user asks it to. */
grantable?: boolean;
}
/**
* Anything a CLI will take as a model, and nothing it could read as a flag: no leading dash, no
* whitespace, no control or format characters. Cursor's `claude-opus-4-8[effort=high]` passes.
*/
export function isModelId(value: unknown): value is string {
return typeof value === 'string' && /^[A-Za-z0-9][^\s\p{C}]{0,199}$/u.test(value);
}
export interface ModelList {
ids: string[];
/** `cli` when the agent's own CLI listed them, `catalog` when it could not and these are curated. */
from: 'cli' | 'catalog';
/** When the CLI's list was read. */
at?: number;
/** Why the last attempt to read it failed. */
error?: string;
}
export interface RunnerStatus {
kind: AgentKind;
bin: string;
ready: boolean;
version?: string;
/** The model this runner will be spawned with; unset means the CLI's own default. */
model?: string;
models?: ModelList;
problem?: AgentProblem;
}
export interface AgentState {
active: AgentKind;
runners: RunnerStatus[];
}
export function activeRunner(state: AgentState | undefined): RunnerStatus | undefined {
return state?.runners.find((runner) => runner.kind === state.active);
}