vibium
The verification layer for coding agents
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/vibiumdev/vibium with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/vibiumdev/vibium'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/vibiumdev--vibium)HTML
<a href="/listings/vibiumdev--vibium"><img src="/api/listings/vibiumdev--vibium/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
npm install -g vibium vibium setup
Agents can run `vibium setup --non-interactive`. Optional: install skills with `npx skills add https://github.com/VibiumDev/vibium`.
Select all Vibium skills in the installer, then choose your agent and installation scope. `vibium setup` installs Chrome when it is missing.
- **browser** — explore pages, automate actions, record sessions, and carry out browser tasks from plain-language instructions. - **check** — independently assess whether a claim holds in the browser or a recording.
Invoke `/browser` or `/check` in agents with slash skills, or `$browser` and `$check` in Codex. Setup guides: [Codex](docs/how-to-guides/using-vibium-with-codex.md), [Claude Code](docs/how-to-guides/using-vibium-with-claude-code.md), and [Claude Desktop Chat via MCP](docs/how-to-guides/using-vibium-with-claude-desktop.md). [Set up Vibium](docs/how-to-guides/setup.md) is the happy path. Run [`vibium ready`](docs/reference/ready.md) to check setup.
For a walkthrough, follow [Your coding agent’s first Check](docs/tutorials/check-with-a-coding-agent.md). Run and Check currently require the development build and AI configuration: `vibium setup` writes `~/.config/vibium/ai.env` (or `vibium config init` for the template). See [model providers](docs/reference/model-providers.md).
See [Introducing Run and Check](docs/updates/2026-09-07-run-and-check.md) for examples and limitations.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 321 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # Vibium
- [](https://www.npmjs.com/package/vibium) [](https://pypi.org/project/vibium/) [](https://central.sonatype.com/artifact/com.vibium/vibium) [](LICENSE)
- **The verification layer for coding agents.**
- Vibium gives AI agents the tools they need to check their work. Install the `browser` skill and your agent can navigate pages, fill forms, click buttons, and take screenshots — all through simple CLI commands. Also available as an MCP server and as JS/TS, Python, and Java client libraries.
- **New here?** Get started in [JavaScript](docs/tutorials/getting-started-js.md), [Python](docs/tutorials/getting-started-python.md), or [Java](docs/tutorials/getting-started-java.md) — zero to hello world in 5 minutes.
- ## Why Vibium?
- - **AI-native.** Install as a skill — your agent learns the full browser automation toolkit instantly.
- - **Zero config.** One install, browser downloads automatically, visible by default.
- - **Standards-based.** Built on [WebDriver BiDi](docs/explanation/webdriver-bidi.md), not proprietary protocols controlled by large corporations.
- - **Lightweight.** A single binary of about 17 MB. No runtime dependencies.
- - **Flexible.** Use as a CLI skill, MCP server, or JS/Python/Java library.
- ---
- ## Agent Setup
- ```bash
- npm install -g vibium
- vibium setup
- ```
- Agents can run `vibium setup --non-interactive`. Optional: install skills with
- `npx skills add https://github.com/VibiumDev/vibium`.
- Select all Vibium skills in the installer, then choose your agent and installation
- scope. `vibium setup` installs Chrome when it is missing.
- - **browser** — explore pages, automate actions, record sessions, and carry out browser tasks from plain-language instructions.
- - **check** — independently assess whether a claim holds in the browser or a recording.
- Invoke `/browser` or `/check` in agents with slash skills, or `$browser` and
- `$check` in Codex. Setup guides: [Codex](docs/how-to-guides/using-vibium-with-codex.md),
- [Claude Code](docs/how-to-guides/using-vibium-with-claude-code.md), and
- [Claude Desktop Chat via MCP](docs/how-to-guides/using-vibium-with-claude-desktop.md).
- [Set up Vibium](docs/how-to-guides/setup.md) is the happy path.
- Run [`vibium ready`](docs/reference/ready.md) to check setup.
- For a walkthrough, follow [Your coding agent’s first Check](docs/tutorials/check-with-a-coding-agent.md).
- Run and Check need Vibium 26.11 or newer and AI configuration:
- `vibium setup` writes `~/.config/vibium/ai.env` (or `vibium config init` for the
- template). See [model providers](docs/reference/model-providers.md).
- See [Introducing Run and Check](docs/updates/2026-09-07-run-and-check.md) for examples and limitations.
- ## CLI Quick Reference
- ```bash
- # Give a browser task (requires AI setup)
- vibium "open https://var.parts and add one battery pack to the cart" --keep-open
- # Or use the explicit run command
- vibium run "open https://var.parts and add one battery pack to the cart" --keep-open
- # Check the cart
- vibium check "the cart contains exactly one battery pack"
- # Check and save a recording
- vibium check "the cart contains exactly one battery pack" -o cart-check.zip
- # Close the browser
- vibium stop
- # Map & interact (the core workflow)
- vibium go https://var.parts # navigate to URL
- vibium map # map interactive elements → @e1, @e2, ...
- vibium click @e1 # click using ref
- vibium diff map # see what changed
- # Find elements (semantic — no CSS needed)
- vibium find "the Sign In button" # find by description → @e1 (page names first, vision model if configured)
- vibium find css "button.primary" # find by exact CSS
- vibium find image icon.png # find where a picture appears
- vibium find text "Sign In" # find by visible text
- vibium find label "Email" # find by form label
- vibium find placeholder "Search" # find by placeholder
- vibium find role button # find by ARIA role
- # Read & capture
- vibium text # get all page text
- vibium screenshot -o page.png # capture screenshot
- vibium screenshot --annotate -o a.png # annotated with element labels
- vibium pdf -o page.pdf # save page as PDF
- vibium eval "document.title" # run JavaScript
- # Wait for things
- vibium wait ".modal" # wait for element to appear
- vibium wait url "/dashboard" # wait for URL change
- vibium wait text "Success" # wait for text on page
- # Record sessions
- vibium record start # record with screenshots
- vibium record stop # stop and save record-<date>-<time>.zip
- # Speak and hear
- vibium say "What's the weather?" # speak into the page's microphone
- vibium listen # hear the page's reply as text
- vibium ready speech # test the speech settings
- # Forms & input
- vibium fill @e2 "hello@example.com" # fill input using ref
- vibium select @e3 "US" # pick dropdown option
- vibium set @e4 # check a checkbox
- vibium press Enter # press a key
- ```
- Full command list: [SKILL.md](skills/browser/SKILL.md)
- **Alternative: MCP server** (for structured tool use instead of CLI):
- ```bash
- claude mcp add vibium -- npx -y vibium mcp # Claude Code
- gemini mcp add vibium npx -y vibium mcp # Gemini CLI
- ```
- See [MCP setup guide](docs/tutorials/getting-started-mcp.md) for options and troubleshooting.
- ---
- ## Language APIs
- ```bash
- npm install vibium # JavaScript/TypeScript
- pip install vibium # Python
- ```
- **Java** (Gradle):
- ```groovy
- implementation 'com.vibium:vibium:26.11.16'
- ```
- **Java** (Maven):
- ```xml
- <dependency>
- <groupId>com.vibium</groupId>
- <artifactId>vibium</artifactId>
- <version>26.11.16</version>
- </dependency>
- ```
- This installs the Vibium binary and downloads Chrome automatically. No manual browser setup required.
- ### JS/TS Client
- **Async API:**
- ```javascript
- import { browser } from 'vibium'
- import fs from 'node:fs/promises'
- const bro = await browser.start()
- const vibe = await bro.page()
- await vibe.go('https://example.com')
- const png = await vibe.screenshot()
- await fs.writeFile('screenshot.png', png)
- const link = await vibe.find({ css: 'a' })
- await link.click()
- await bro.stop()
- ```
- **Sync API:**
- ```javascript
- const { browser } = require('vibium/sync')
- const fs = require('fs')
- const bro = browser.start()
- const vibe = bro.page()
- vibe.go('https://example.com')
- const png = vibe.screenshot()
- fs.writeFileSync('screenshot.png', png)
- const link = vibe.find({ css: 'a' })
- link.click()
- bro.stop()
- ```
- ### Python Client
- ```python
- # Async
- from vibium.async_api import browser
- # Sync (default)
- from vibium import browser
- ```
- **Async API:**
- ```python
- import asyncio
- from vibium.async_api import browser
- async def main():
- bro = await browser.start()
- vibe = await bro.page()
- await vibe.go("https://example.com")
- png = await vibe.screenshot()
- with open("screenshot.png", "wb") as f:
- f.write(png)
- link = await vibe.find(css="a")
- await link.click()
- await bro.stop()
- asyncio.run(main())
- ```
- **Sync API:**
- ```python
- from vibium import browser
- bro = browser.start()
- vibe = bro.page()
- vibe.go("https://example.com")
- png = vibe.screenshot()
- with open("screenshot.png", "wb") as f:
- f.write(png)
- link = vibe.find(css="a")
- link.click()
- bro.stop()
- ```
- ### Java Client
- ```java
- var bro = Vibium.start();
- var vibe = bro.page();
- vibe.go("https://example.com");
- var png = vibe.screenshot();
- Files.write(Path.of("screenshot.png"), png);
- var link = vibe.find(new SelectorOptions().css("a"));
- link.click();
- bro.stop();
- ```
- ---
- ## Architecture
- ```
- ┌──────────────────────────────────────┐
- │ LLM / Agent │
- │ (Claude Code, Codex, Gemini, etc.) │
- └──────────────────────────────────────┘
- ▲ ▲
- │ CLI (Bash) │ MCP (stdio)
- ▼ ▼
- ┌───────────────────────────────────┐
- │ Vibium binary │
- │ │
- │ ┌──────────────┐ ┌────────────┐ │
- │ │ CLI Commands │ │ MCP Server │ │
- │ └─────┬────────┘ └──────┬─────┘ │ ┌──────────────────┐
- │ └───────▲─────────┘ │ │ │
- │ │ │ │ │
- │ ┌──────▼───────┐ │ BiDi │ Web Browser │
- │ │ BiDi Proxy │ │◄──────►│ │
- │ └──────────────┘ │ │ │
- └───────────────────────────────────┘ └──────────────────┘
- ▲
- │ WebSocket BiDi :9515
- ▼
- ┌──────────────────────────────────────┐
- │ Client Libraries │
- │ (js/ts | python | java) │
- │ │
- │ ┌─────────────────┐ ┌────────────┐ │
- │ │ Async API │ │ Sync API │ │
- │ │ await vibe.go() │ │ vibe.go() │ │
- │ └─────────────────┘ └────────────┘ │
- └──────────────────────────────────────┘
- ```
- ---
- ## Platform Support
- | Platform | Architecture | Status |
- |----------|--------------|--------|
- | Linux | x64 | ✅ Supported |
- | Linux | arm64 | ✅ Supported |
- | macOS | x64 (Intel) | ✅ Supported |
- | macOS | arm64 (Apple Silicon) | ✅ Supported |
- | Windows | x64 | ✅ Supported |
- Chrome is the default browser; Firefox is also supported ([how to switch](docs/how-to-guides/using-firefox.md)). Firefox 154+ can [record video of a session](docs/how-to-guides/record-video.md).
- ---
- ## Contributing
- See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
- Source builds require Go, Node.js/npm, and Java 21 because the default `make`
- target builds the Go binary, JS client, and Java client.
- ---
- ## What's next
- There is no single roadmap. Feature requests and bugs are in the
- [issues](https://github.com/VibiumDev/vibium/issues). Designs are in
- [docs/specs](docs/specs/), and not every one will be built. Related work
- happens in [Vibium Station](https://github.com/VibiumDev/station),
- [Roadie](https://github.com/VibiumDev/roadie) and the
- [Record Player](https://github.com/VibiumDev/record-player).
- ---
- ## License
- Apache 2.0
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.