integrated-browser

Explains the architecture and mental model of the VS Code integrated Chromium browser.

10|1|Updated Jul 13, 2026
One-click install
npx skills add https://github.com/KevinHuangIsLearning/shortestpath-ide --skill integrated-browser-kevinhuangislearning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integrated-browser
Source: https://github.com/KevinHuangIsLearning/shortestpath-ide/tree/main/.github/skills/integrated-browser
Command: npx skills add https://github.com/KevinHuangIsLearning/shortestpath-ide --skill integrated-browser-kevinhuangislearning

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working on the VS Code integrated browser (browserView) requires understanding a multi-process, security-sensitive architecture where a native Chromium WebContentsView floats above the workbench DOM. This Skill provides the load-bearing mental model so you can modify the browser without breaking alignment, focus, sessions, or agent tooling. ## Core Features & Use Cases - Three-process architecture map: explains the split between main (native view ownership), shared (Playwright automation), and renderer (editor UI and agent tools) processes and their IPC boundaries. - Overlay and layout guidance: covers the pixel-snapped bounds, z-order hiding, screenshot masking, and preload-based keyboard routing needed to coordinate a native view painted above the DOM. - Identity and security model: clarifies sessions (storage identity), groups (automation visibility), the proxied CDP layer, and the privacy gates controlling agent access to page content. - Use Case: When adding a new browser capability, use this Skill to learn that you should write a new editor contribution modeled on a sibling, mirror new state from the main process via events, and compose layout through prioritized overrides rather than hard-coding pixels. ## Quick Start Ask the AI to explain how the VS Code integrated browser coordinates the native WebContentsView with the workbench DOM before modifying browserView code.

Frequently Asked Questions about integrated-browser

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does the VS Code integrated browser render web pages?

The integrated browser embeds a real Chromium page as an Electron WebContentsView owned by the main process. It is painted by the OS compositor on top of the workbench DOM, and the renderer holds only a proxy model that communicates with main over IPC channels.

How do I add a new feature to the VS Code browserView editor?

Add behavior by writing a new contribution modeled on an existing sibling rather than growing the editor or main view. Contributions attach to the editor with a scoped lifecycle, and layout-affecting ones compose through prioritized overrides instead of hard-coded pixels.

Why does the native browser view show through menus or misalign in VS Code?

The native view paints above all workbench UI in screen coordinates, so CSS z-index cannot fix overlap. The workbench detects overlapping floating UI and hides the native view with a placeholder, and bounds must be pixel-snapped because CSS zoom and screen pixels disagree.

Can AI agents access page content in the VS Code integrated browser?

Agents drive the same WebContentsView the user sees via Playwright over CDP, but page content is private until shared. A sharing state gates content access, a separate availability gate controls tool registration, and URLs are screened by a network filter.

Does the VS Code integrated browser work on the web version?

No, the integrated browser is desktop-only because it depends on Electron's native WebContentsView. New capabilities go into electron-main or node layers, while browser stubs throw a not-available-in-web error.