Show HN：Webctl – 基於 CLI 的瀏覽器自動化，適用於代理而非 MCP

Navigation Menu

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

To see all available qualifiers, see our documentation.

Browser automation via CLI — for humans and agents

Uh oh!

There was an error while loading. Please reload this page.

cosinusalpha/webctl

Folders and files

Latest commit

History

Repository files navigation

webctl

Browser automation for AI agents and humans, built on the command line.

Why CLI Instead of MCP?

MCP browser tools have a fundamental problem: the server controls what enters your context. With Playwright MCP, every response includes the full accessibility tree plus console messages (default: "info" level). After a few page queries, your context is full.

CLI flips this around: you control what enters context.

Beyond filtering, CLI gives you:

Quick Start

Verify it works:

Core Concepts

Sessions

Browser stays open across commands. Cookies persist to disk.

Element Queries

Semantic targeting based on ARIA roles - stable across CSS refactors:

Output Control

Commands

Navigation

Observation

Interaction

Wait Conditions

Session Management

Console Logs

Setup & Config

Agent Integration

Tell your AI agent to use webctl. The easiest way:

Or manually add to your agent's config:

For AI Agents

This section is designed to be read by AI agents directly.

webctl Quick Reference

Control a browser via CLI. Start with webctl start, end with webctl stop --daemon.

Commands:

Query syntax:

Example - Login:

Tips:

Architecture

License

MIT

About

Browser automation via CLI — for humans and agents

Resources

Uh oh!

There was an error while loading. Please reload this page.

Stars

Watchers

Forks

Releases

Packages

  0

Uh oh!

There was an error while loading. Please reload this page.

Languages

Footer

Footer navigation