surf

Automates Chrome via CLI for navigation, interaction, screenshots, and emulation.

578|51|Updated Dec 28, 2025
One-click install
npx skills add https://github.com/nicobailon/surf-cli --skill surf-nicobailon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: surf
Source: https://github.com/nicobailon/surf-cli/tree/main/skills/surf
Command: npx skills add https://github.com/nicobailon/surf-cli --skill surf-nicobailon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Surf addresses the need to automate browser tasks, debug web interactions, and emulate user actions without manual clicking, capturing, or scripting.

Core Features & Use Cases

  • Agent-agnostic: Works with any AI agent through a CLI interface or Unix socket.
  • Browser control & automation: Navigate, interact, capture screenshots, read page state, and emulate networks or CPU for testing.
  • AI-assisted prompts in the browser: Query or assist with AI models inside Chrome sessions, with no API keys needed.

Quick Start

Install Surf globally and run a sample command to automate a browser task.

Frequently Asked Questions about surf

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

FAQPage Schema
How do I automate Chrome browser tasks using a CLI?

You can automate Chrome browser tasks by running a CLI to control navigation, interact with elements, capture screenshots, and read page state locally. This CLI operates safely with defaults and requires no manual clicking or scripting.

Can I use AI to query page state inside a Chrome session without an API key?

Yes, you can use AI-assisted prompts to query or assist with AI models inside Chrome sessions without needing API keys. The browser control tool integrates AI directly through its CLI interface or Unix socket.

How do I emulate network and CPU performance for browser testing?

You can emulate network and CPU performance for browser testing by executing groupable CLI commands within a Chrome session. This allows you to debug web interactions and emulate user actions under specific network constraints.

Does this Chrome automation tool work with any AI agent?

Yes, the Chrome automation tool is agent-agnostic and works with any AI agent through a CLI interface or Unix socket. This allows flexible integration with various AI models for automated browser control.

What is the best way to manage multiple tabs and windows during web automation?

The best way to manage multiple tabs and windows during web automation is using a CLI with groupable commands for tab and window management. This enables efficient navigation and interaction across multiple browser sessions locally.

How do I capture screenshots during automated browser navigation?

You can capture screenshots during automated browser navigation by executing specific CLI commands designed for browser control. This captures page state and visual output directly within your local Chrome session for debugging.