surf

Control Chrome browser sessions via CLI and Unix socket for automation.

3|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/legout/pi-config --skill surf-legout
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: surf
Source: https://github.com/legout/pi-config/tree/main/installed-skills/surf
Command: npx skills add https://github.com/legout/pi-config --skill surf-legout

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the need for manual browser interaction by providing a robust CLI interface to control Chrome, enabling automated testing, web scraping, and AI-assisted browsing workflows.

Core Features & Use Cases

  • Browser Control: Perform complex navigation, tab management, and window orchestration directly from the terminal.
  • AI Integration: Query ChatGPT, Gemini, Perplexity, and Grok using your existing browser sessions without needing API keys.
  • Automation Workflows: Execute multi-step sequences like logging into websites, filling forms, and capturing screenshots with built-in auto-waits and error diagnostics.

Quick Start

Use the surf skill to navigate to a website and capture a full-page screenshot for debugging purposes.

Frequently Asked Questions about surf

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

FAQPage Schema
How do I automate browser interaction and web scraping from the command line?

Browser automation from the command line is achieved by using a CLI and Unix socket to control Chrome, enabling automated web scraping, tab management, and multi-step workflow execution without manual interaction.

Can I query AI models like ChatGPT and Gemini through browser automation without API keys?

You can query AI models like ChatGPT, Gemini, Perplexity, and Grok during browser automation by utilizing your existing active browser sessions, entirely bypassing the need for separate API keys.

How do I execute multi-step web automation workflows for form filling and testing?

Multi-step web automation workflows for form filling and testing are executed via the CLI, which supports deterministic sequences, built-in auto-waits, network emulation, and robust error handling diagnostics.

Does browser automation support network emulation and element inspection for automated testing?

Browser automation supports network emulation and element inspection for automated testing, providing comprehensive control over complex web interactions directly through the terminal interface.

What is the best way to capture full-page screenshots for debugging using CLI browser control?

Capturing full-page screenshots for debugging is best handled by navigating to the target website via the CLI browser control, which orchestrates the session and captures the page state automatically.

Why use CLI browser automation over standard web scraping tools for complex web interactions?

CLI browser automation provides robust error handling, active session utilization for AI querying, and deterministic multi-step workflow execution, offering deeper control than standard web scraping tools.