gowtham2036/browser-ai

Purpose and Runtime

Browser-AI is a cross-platform desktop browser experience with AI-assisted browsing. It combines a React/Vite renderer with a Rust/Tauri desktop host. The application entry points are src/main.tsx for the renderer and src-tauri/src/main.rs / src-tauri/src/lib.rs for the native process.

Desktop Host and Security Boundary

Tauri packages and launches the frontend as a desktop application, owns native-window integration, and applies capability/permission policy. Core host configuration and access boundaries are in:

• src-tauri/tauri.conf.json

• src-tauri/capabilities/default.json

• src-tauri/permissions/app.toml

Rust dependencies and build behavior are defined by src-tauri/Cargo.toml and src-tauri/build.rs.

Application Composition

src/App.tsx is the renderer-level composition root, with global styling in src/App.css and src/index.css. It assembles the browser surface, navigation controls, tab UI, reader mode, settings, and side-panel workflows:

• src/components/BrowserShell.tsx

• src/components/TabBar.tsx

• src/components/Omnibox.tsx

Browser State and UI Control Flow

The browser’s shared client-side state is centered in src/store/browserStore.ts. Browser UI components read and mutate this store to drive navigation, tab selection, panels, reader-mode state, and related application state. Common domain contracts are concentrated in src/types/index.ts, separating UI and agent services from concrete state representations.

AI Agent Pipeline

The AI subsystem is organized as an explicit observe-plan/loop-execute flow. src/services/agent.ts is the service-facing agent entry point; the implementation is divided into:

• src/services/agent/agentLoop.ts — coordinates iterative agent work.

• src/services/agent/observer.ts — derives browser/page context for the agent.

• src/services/agent/actions.ts and src/services/agent/executor.ts — define and perform browser actions.

This is the main control boundary between model-directed intent and mutations to browser/UI state.

AI and Persistence Services

src/services/ai.ts encapsulates AI/model-facing integration, keeping model interaction outside React components and the agent executor. src/services/db.ts provides persistence access behind a frontend service boundary. Shared service-level behavior lives in src/services/utils.ts. External AI and storage providers are not identified in the supplied repository metadata; their concrete configuration should be verified in these service files.

Agent Visibility and User Interaction

The side panel exposes the agent as a user-facing workflow rather than an opaque background process. Its chat, controls, status/timeline, debugging, and intelligence views are split across:

• src/components/sidepanel/SidePanelChat.tsx

• src/components/sidepanel/AgentControls.tsx

• src/components/sidepanel/AgentTimeline.tsx

src/components/sidepanel/AgentDebug.tsx and src/components/sidepanel/IntelPanel.tsx provide observability/context views, while src/components/SidePanel.tsx integrates them with the main browser shell.