| title | Getting Started |
|---|
This page walks through your first real session with Vibium. It assumes you
have either installed the vibium binary globally or
are running it via npx -y vibium .... The two are interchangeable; pick
whichever you prefer.
Tip. If you don't want to install anything, alias
npxfor the session and the examples below work unchanged:alias vibium='npx -y vibium'
A Vibium session is a sequence of CLI commands that share a single browser. Vibium runs a small daemon in the background to keep the browser alive between commands, so each invocation is fast and you can interleave commands with your own scripting.
A typical loop looks like:
vibium go <url>— open a page.vibium map— list interactive elements with stable references like@e1,@e2,@e3.vibium click @e2orvibium fill @e3 "..."— act on those references.vibium textorvibium screenshot— read the result.
This is the same loop an agent uses; the references are designed to be easy for an LLM to reason about and stable across commands.
Open the Vibium homepage and grab a screenshot:
vibium go https://example.com
vibium screenshot -o example.pngList the interactive elements on the page:
vibium mapYou should see lines like:
@e1 link "More information..." (https://www.iana.org/...)
Click the first link by reference:
vibium click @e1Wait for the new page to settle, then read its text:
vibium wait text "IANA"
vibium textCSS selectors are brittle. Vibium prefers semantic locators that match what a human would describe:
vibium find text "Sign in"
vibium find label "Email"
vibium find placeholder "Search..."
vibium find role buttonEach find returns one or more @e references you can then click, fill,
or otherwise act on.
- Tutorial — a complete form-filling walkthrough.
- Core Concepts — references, mapping, daemon mode.
- Command Reference — every command in detail.
(If you skipped the Quickstart, it's a condensed copy-paste version of this page.)