Skip to content

Part 1: Check a live website

Check tutorials: Part 1 · Part 2: Coding agents · Part 3: Recordings and traces

Check whether a website is up, then save the result, screenshots, and browser actions in a recording. You don’t need a coding agent or a test script.

You need Node.js with npm and a Vibium build that includes Check. Install Vibium using the installation instructions, then confirm:

Terminal window
vibium check --help

The shell examples use Bash or Zsh on macOS or Linux. These tutorials need Vibium 26.11 or newer. If your installed version has no check command, update it (npm install -g vibium). To use a binary built from a checkout instead, put ./clicker/bin/vibium in place of vibium below. Build instructions are available for macOS and Linux.

Run and Check use Vibium’s own model configuration. Your coding agent’s subscription does not configure it automatically. This example uses OpenAI; for other providers, use the provider guide.

If you already have working settings, keep them and load them below. Otherwise, create a private settings file:

Terminal window
vibium config init
# Wrote /Users/you/.config/vibium/ai.env (0600) — provider, model and API key for run and check
# Edit it, then run vibium. Empty AI variables are loaded from this file.

That writes a commented file readable only by you. Open ~/.config/vibium/ai.env in your editor and set:

Terminal window
export VIBIUM_AI_PROVIDER=openai
export VIBIUM_AI_MODEL=gpt-5.6-sol
export VIBIUM_AI_REASONING_EFFORT=none
export OPENAI_API_KEY='replace-with-your-api-key'

Use a model your API account can access. VIBIUM_AI_REASONING_EFFORT=none is the right setting for this model; other OpenAI models may want a different value, and Anthropic and Google models want it left unset. Keep export on each line so the settings reach Vibium, and keep your actual key in the file rather than chat or project source code.

Then run readiness in any terminal:

Terminal window
vibium ready

Wait for browser installation and AI checks to pass. Readiness checks browser files without opening a browser. If one is missing, run the suggested vibium install command, then retry. Other failures also include a suggested fix. These shared settings work for both Run and Check.

Terminal window
vibium check "https://var.parts is up"

A browser opens and the result appears in your terminal. This Firefox run on September 7, 2026 returned:

CHECK: https://var.parts is up
PASS
https://var.parts is up and serving its storefront page.
- Navigation completed successfully at https://var.parts/.
- The page rendered with the title “Vibium Shop — VAR Parts & Upgrades,” navigation, product listings, images, and buttons.

PASS means the evidence supports the claim. FAIL means it contradicts the claim. REVIEW means the model couldn’t decide. Your result may differ; this is a small availability check, not a test of every site feature.

A browser started by Check closes afterward. An existing Vibium browser stays open. Add --keep-open to preserve a newly started browser too.

Repeat the check with -o:

Terminal window
vibium check "https://var.parts is up" -o sitecheck.zip

You’ll get the verdict and evidence again, followed by:

Recording saved to sitecheck.zip

Open Record Player and drop the ZIP onto it. Expand the Check group to inspect the result and browser actions, and step through the screenshots. Use a new output filename for each run.

Here is var.parts after the Firefox check shown above:

VAR Parts storefront after a successful Firefox check

Keep sitecheck.zip for Part 3.

Once the browser from this exercise is closed, run the same check on Firefox to get video:

Terminal window
vibium install --engine firefox
vibium check "https://var.parts is up" -o sitecheck-firefox.zip --engine firefox

If you used --keep-open, close that browser with vibium stop before switching engines. An unrelated existing session should be preserved; finish this exercise in a separate session if needed.

Firefox records WebM video from version 154; the release channel is well past that, so no channel flag is needed. Chrome currently records actions and screenshots without continuous video. Record Player can play the video from your ZIP.

Watch the var.parts check

This is the same Firefox run as the screenshot and PASS result above. The GIF preview plays at normal speed with fewer frames; the WebM is the original browser video.

Video preview of Check opening the VAR Parts storefront

Watch the original WebM video.

Next, use Check with your coding agent, or check the saved recording.