index.md

title	Overview
sidebar	order 0

The Vibium CLI commands you'll reach for in day-to-day use, grouped by purpose. Each entry has its own page with syntax, flags, and examples.

Scope. This reference covers the commands needed to drive the quickstart, the tutorial, and the typical agent loop. The vibium binary exposes additional lower-level commands (run vibium --help to list them) — they're useful escape hatches but are not part of the documented surface yet.

Navigation

• vibium go — navigate to a URL.

Mapping & references

• vibium map — list interactive elements as @eN references.
• vibium diff map — show how the page has changed since the last map.

Finding elements

• vibium find — locate elements semantically by text, label, placeholder, or ARIA role.

Interacting

• vibium click — click an element by reference.
• vibium fill — type text into an input.
• vibium select — choose a dropdown option.
• vibium check — toggle a checkbox.
• vibium press — send a keystroke.

Waiting

• vibium wait — block until an element, URL, or text appears.

Capture

• vibium text — extract page text.
• vibium screenshot — save a PNG screenshot.
• vibium pdf — save the page as a PDF.
• vibium eval — run JavaScript in the page.

Recording

• vibium record — start/stop a session recording.

Agent integration

• vibium mcp — start the MCP server.

Conventions

• Arguments shown as <x> are required; [x] are optional.
• @eN always refers to a numeric element reference returned by map or find.
• All commands share a single browser/daemon, so state persists across calls.
• Output is plain text on stdout unless a -o flag specifies a file.

Running without installing

Every command on every page below also works through npx — no global install required:

npx -y vibium go https://example.com
npx -y vibium map
npx -y vibium screenshot -o page.png

For a session-wide alias:

alias vibium='npx -y vibium'