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 AppKit
import Foundation
enum CheckID: String, CaseIterable, Identifiable {
case system, node, command, browser, agent
var id: String { rawValue }
var title: String {
switch self {
case .system: "This Mac"
case .node: "Node.js runtime"
case .command: "Browsentic Bridge"
case .browser: "A browser"
case .agent: "An AI agent"
}
}
var icon: String {
switch self {
case .system: "laptopcomputer"
case .node: "hexagon"
case .command: "terminal"
case .browser: "globe"
case .agent: "sparkles"
}
}
/// What "Set up everything" installs on its own. A browser, the extension and an agent are the user's pick.
var installsAutomatically: Bool { self == .node || self == .command }
var blocksEntry: Bool { installsAutomatically }
}
enum CheckState: Equatable {
case waiting
case checking
case passed(String)
case missing(String)
case advisory(String)
case working(Double?, String)
case failed(String)
var isPassed: Bool { if case .passed = self { true } else { false } }
var needsAttention: Bool {
switch self {
case .missing, .failed: true
default: false
}
}
}
struct Browser: Identifiable, Equatable {
let name: String
let bundleId: String
let url: URL
var id: String { bundleId }
static let known: [(String, String)] = [
("Google Chrome", "com.google.Chrome"),
("Brave", "com.brave.Browser"),
("Microsoft Edge", "com.microsoft.edgemac"),
("Arc", "company.thebrowser.Browser"),
("Vivaldi", "com.vivaldi.Vivaldi"),
("Opera", "com.operasoftware.Opera"),
("Chromium", "org.chromium.Chromium"),
("Firefox", "org.mozilla.firefox"),
]
/// Firefox has no chrome://extensions page and cannot load an unpacked Chromium build.
var isChromium: Bool { bundleId != "org.mozilla.firefox" }
static func installed() -> [Browser] {
known.compactMap { name, bundleId in
NSWorkspace.shared.urlForApplication(withBundleIdentifier: bundleId).map { Browser(name: name, bundleId: bundleId, url: $0) }
}
}
/// Chrome refuses chrome:// URLs from the command line, but takes them over Apple Events.
@discardableResult
func openExtensionsPage() -> Bool {
let source = "tell application id \"\(bundleId)\"\nactivate\nopen location \"chrome://extensions\"\nend tell"
var error: NSDictionary?
NSAppleScript(source: source)?.executeAndReturnError(&error)
if error != nil { NSWorkspace.shared.openApplication(at: url, configuration: .init()) }
return error == nil
}
}
enum AgentProbe {
static let bins: [(String, String)] = [
("Claude Code", "claude"),
("Codex", "codex"),
("Antigravity", "agy"),
("Mistral Vibe", "vibe"),
("Grok Build", "grok"),
("Cursor CLI", "cursor-agent"),
("Qwen Code", "qwen"),
("OpenCode", "opencode"),
("DeepSeek Harness", "dsh"),
]
static func installed() -> [String] {
bins.filter { Shell.which($0.1) != nil }.map(\.0)
}
}
enum ExtensionFiles {
static func stamp() -> InstallStamp? {
let url = Paths.extensionDir().appendingPathComponent(".browsentic-install.json")
return (try? Data(contentsOf: url)).flatMap { try? JSONDecoder().decode(InstallStamp.self, from: $0) }
}
}