Cmux Browser

This handles browser automation inside cmux webviews using a snapshot and element reference workflow. You open a surface, verify the URL loaded, take an interactive snapshot to get fresh element refs like e1 or e2, then click or fill those refs. It supports common wait patterns for selectors, text, URL changes, and load states. The WKWebView foundation means no CDP tricks like network interception or viewport emulation, but the high-level commands cover most form filling and navigation tasks. One sharp edge: complex pages can throw js_error on snapshots, so you fall back to get text body or get html body. The skill includes templates for login flows and session state persistence, which matters when you need to stay authenticated across surfaces.

skills.sh installs: 9K
GitHub stars: 28.7K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add manaflow-ai/cmux --skill cmux-browser --agent claude-code

Installs into .claude/skills of the current project.

Files

Browser Automation with cmux

Read the CLI contract first

Check the binary that will actually run before giving an exact command:

cmux browser --help
cmux --version

There are two deliberately different command shapes:

Create a browser surface with open, open-split, or new. These commands may be workspace-scoped and do not need a surface handle.
Use an existing surface with every surface-bound navigation, inspection, interaction, tab, state, or diagnostic command. Pass the handle explicitly with --surface <handle> or as the first positional token.

Prefer the flag form in scripts because it makes the target unmissable:

SURFACE="surface:7" # use a ref returned by discovery; do not guess an index
cmux browser --surface "$SURFACE" get url
cmux browser --surface "$SURFACE" get-url       # accepted alias
cmux browser --surface "$SURFACE" snapshot --interactive
cmux browser --surface "$SURFACE" snapshot -i   # accepted alias
cmux browser --surface "$SURFACE" url            # accepted alias
cmux browser --surface "$SURFACE" tab list
cmux browser --surface "$SURFACE" click e1 --snapshot-after

SKILL.md on GitHub

Details

Repository: github.com/manaflow-ai/cmux
Category: Automation & Workflows
First seen: Apr 16, 2026