headful-browser-vnc

Launch a headful Chromium session with VNC/noVNC operator UI and CDP artifact exports.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/WaylonSong/headful-browser-vnc --skill headful-browser-vnc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: headful-browser-vnc
Source: https://github.com/WaylonSong/headful-browser-vnc/tree/main
Command: npx skills add https://github.com/WaylonSong/headful-browser-vnc --skill headful-browser-vnc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Xvfb, x11vnc, fluxbox, chromium-browser, google-chrome-stable, nodejs, npm, playwright, wget, vncpasswd, and includes scripts (resource) components.

What problem does it solve?

Provides a controlled, auditable headful Chrome session exposed via VNC/noVNC for operator intervention and automated CDP data exports (cookies, HTML, screenshots).

Core Features & Use Cases

  • Headful browser execution with an isolated profile and per-session VNC/NoVNC UI for human-in-the-loop tasks.
  • Programmatic artifact export via Chrome DevTools Protocol (cookies, outerHTML, full-page screenshots) to downstream pipelines.
  • Safe restart, artifact hygiene, and strict access controls to protect sensitive data during operator-enabled workflows.

Quick Start

Run a VNC-enabled Chrome session, connect with a VNC client, and use the CDP ports to export artifacts.

Frequently Asked Questions about headful-browser-vnc

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

FAQPage Schema
How do I automate CAPTCHA solving with a headful Chrome session?

Programmatic artifact export via Chrome DevTools Protocol captures cookies, outerHTML, and full-page screenshots, routing them to the out/ directory for downstream automation pipelines.

Can I use Playwright for human-in-the-loop browser automation?

Yes, Playwright drives the headful Chromium instance while a VNC/noVNC operator UI exposes the session, enabling manual operator intervention for complex authentications within automated workflows.

How do I export cookies and screenshots using Chrome DevTools Protocol?

Chrome DevTools Protocol exports cookies, outerHTML, and full-page screenshots from the headful Chromium session, routing these artifacts to the out/ directory for downstream pipelines.

Do I need Xvfb and x11vnc to run headful Chromium for guided automation?

Yes, Xvfb and x11vnc provide the virtual framebuffer and VNC server required to expose the headful Chromium operator UI, enabling secure remote access during guided automation workflows.

What is the best way to capture browser artifacts during manual authentication?

Using a headful Chromium session exposed via noVNC allows operators to manually complete authentication while CDP exports capture cookies, outerHTML, and screenshots to the out/ directory.

How does VNC operator UI protect sensitive data during automation?

The VNC operator UI enforces strict access controls and artifact hygiene during headful Chrome workflows, managing runtime artifacts and logs to guard sensitive data during operator-enabled sessions.