Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/vibiumdev--vibium/badge.svg)](/listings/vibiumdev--vibium)

HTML

<a href="/listings/vibiumdev--vibium"><img src="/api/listings/vibiumdev--vibium/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

  1. # Vibium
  2. [![npm](https://img.shields.io/npm/v/vibium)](https://www.npmjs.com/package/vibium) [![PyPI](https://img.shields.io/pypi/v/vibium)](https://pypi.org/project/vibium/) [![Maven Central](https://img.shields.io/maven-central/v/com.vibium/vibium)](https://central.sonatype.com/artifact/com.vibium/vibium) [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
  3. **The verification layer for coding agents.**
  4. 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.
  5. **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.
  6. ## Why Vibium?
  7. - **AI-native.** Install as a skill — your agent learns the full browser automation toolkit instantly.
  8. - **Zero config.** One install, browser downloads automatically, visible by default.
  9. - **Standards-based.** Built on [WebDriver BiDi](docs/explanation/webdriver-bidi.md), not proprietary protocols controlled by large corporations.
  10. - **Lightweight.** A single binary of about 17 MB. No runtime dependencies.
  11. - **Flexible.** Use as a CLI skill, MCP server, or JS/Python/Java library.
  12. ---
  13. ## Agent Setup
  14. ```bash
  15. npm install -g vibium
  16. vibium setup
  17. ```
  18. Agents can run `vibium setup --non-interactive`. Optional: install skills with
  19. `npx skills add https://github.com/VibiumDev/vibium`.
  20. Select all Vibium skills in the installer, then choose your agent and installation
  21. scope. `vibium setup` installs Chrome when it is missing.
  22. - **browser** — explore pages, automate actions, record sessions, and carry out browser tasks from plain-language instructions.
  23. - **check** — independently assess whether a claim holds in the browser or a recording.
  24. Invoke `/browser` or `/check` in agents with slash skills, or `$browser` and
  25. `$check` in Codex. Setup guides: [Codex](docs/how-to-guides/using-vibium-with-codex.md),
  26. [Claude Code](docs/how-to-guides/using-vibium-with-claude-code.md), and
  27. [Claude Desktop Chat via MCP](docs/how-to-guides/using-vibium-with-claude-desktop.md).
  28. [Set up Vibium](docs/how-to-guides/setup.md) is the happy path.
  29. Run [`vibium ready`](docs/reference/ready.md) to check setup.
  30. For a walkthrough, follow [Your coding agent’s first Check](docs/tutorials/check-with-a-coding-agent.md).
  31. Run and Check need Vibium 26.11 or newer and AI configuration:
  32. `vibium setup` writes `~/.config/vibium/ai.env` (or `vibium config init` for the
  33. template). See [model providers](docs/reference/model-providers.md).
  34. See [Introducing Run and Check](docs/updates/2026-09-07-run-and-check.md) for examples and limitations.
  35. ## CLI Quick Reference
  36. ```bash
  37. # Give a browser task (requires AI setup)
  38. vibium "open https://var.parts and add one battery pack to the cart" --keep-open
  39. # Or use the explicit run command
  40. vibium run "open https://var.parts and add one battery pack to the cart" --keep-open
  41. # Check the cart
  42. vibium check "the cart contains exactly one battery pack"
  43. # Check and save a recording
  44. vibium check "the cart contains exactly one battery pack" -o cart-check.zip
  45. # Close the browser
  46. vibium stop
  47. # Map & interact (the core workflow)
  48. vibium go https://var.parts # navigate to URL
  49. vibium map # map interactive elements → @e1, @e2, ...
  50. vibium click @e1 # click using ref
  51. vibium diff map # see what changed
  52. # Find elements (semantic — no CSS needed)
  53. vibium find "the Sign In button" # find by description → @e1 (page names first, vision model if configured)
  54. vibium find css "button.primary" # find by exact CSS
  55. vibium find image icon.png # find where a picture appears
  56. vibium find text "Sign In" # find by visible text
  57. vibium find label "Email" # find by form label
  58. vibium find placeholder "Search" # find by placeholder
  59. vibium find role button # find by ARIA role
  60. # Read & capture
  61. vibium text # get all page text
  62. vibium screenshot -o page.png # capture screenshot
  63. vibium screenshot --annotate -o a.png # annotated with element labels
  64. vibium pdf -o page.pdf # save page as PDF
  65. vibium eval "document.title" # run JavaScript
  66. # Wait for things
  67. vibium wait ".modal" # wait for element to appear
  68. vibium wait url "/dashboard" # wait for URL change
  69. vibium wait text "Success" # wait for text on page
  70. # Record sessions
  71. vibium record start # record with screenshots
  72. vibium record stop # stop and save record-<date>-<time>.zip
  73. # Speak and hear
  74. vibium say "What's the weather?" # speak into the page's microphone
  75. vibium listen # hear the page's reply as text
  76. vibium ready speech # test the speech settings
  77. # Forms & input
  78. vibium fill @e2 "hello@example.com" # fill input using ref
  79. vibium select @e3 "US" # pick dropdown option
  80. vibium set @e4 # check a checkbox
  81. vibium press Enter # press a key
  82. ```
  83. Full command list: [SKILL.md](skills/browser/SKILL.md)
  84. **Alternative: MCP server** (for structured tool use instead of CLI):
  85. ```bash
  86. claude mcp add vibium -- npx -y vibium mcp # Claude Code
  87. gemini mcp add vibium npx -y vibium mcp # Gemini CLI
  88. ```
  89. See [MCP setup guide](docs/tutorials/getting-started-mcp.md) for options and troubleshooting.
  90. ---
  91. ## Language APIs
  92. ```bash
  93. npm install vibium # JavaScript/TypeScript
  94. pip install vibium # Python
  95. ```
  96. **Java** (Gradle):
  97. ```groovy
  98. implementation 'com.vibium:vibium:26.11.16'
  99. ```
  100. **Java** (Maven):
  101. ```xml
  102. <dependency>
  103. <groupId>com.vibium</groupId>
  104. <artifactId>vibium</artifactId>
  105. <version>26.11.16</version>
  106. </dependency>
  107. ```
  108. This installs the Vibium binary and downloads Chrome automatically. No manual browser setup required.
  109. ### JS/TS Client
  110. **Async API:**
  111. ```javascript
  112. import { browser } from 'vibium'
  113. import fs from 'node:fs/promises'
  114. const bro = await browser.start()
  115. const vibe = await bro.page()
  116. await vibe.go('https://example.com')
  117. const png = await vibe.screenshot()
  118. await fs.writeFile('screenshot.png', png)
  119. const link = await vibe.find({ css: 'a' })
  120. await link.click()
  121. await bro.stop()
  122. ```
  123. **Sync API:**
  124. ```javascript
  125. const { browser } = require('vibium/sync')
  126. const fs = require('fs')
  127. const bro = browser.start()
  128. const vibe = bro.page()
  129. vibe.go('https://example.com')
  130. const png = vibe.screenshot()
  131. fs.writeFileSync('screenshot.png', png)
  132. const link = vibe.find({ css: 'a' })
  133. link.click()
  134. bro.stop()
  135. ```
  136. ### Python Client
  137. ```python
  138. # Async
  139. from vibium.async_api import browser
  140. # Sync (default)
  141. from vibium import browser
  142. ```
  143. **Async API:**
  144. ```python
  145. import asyncio
  146. from vibium.async_api import browser
  147. async def main():
  148. bro = await browser.start()
  149. vibe = await bro.page()
  150. await vibe.go("https://example.com")
  151. png = await vibe.screenshot()
  152. with open("screenshot.png", "wb") as f:
  153. f.write(png)
  154. link = await vibe.find(css="a")
  155. await link.click()
  156. await bro.stop()
  157. asyncio.run(main())
  158. ```
  159. **Sync API:**
  160. ```python
  161. from vibium import browser
  162. bro = browser.start()
  163. vibe = bro.page()
  164. vibe.go("https://example.com")
  165. png = vibe.screenshot()
  166. with open("screenshot.png", "wb") as f:
  167. f.write(png)
  168. link = vibe.find(css="a")
  169. link.click()
  170. bro.stop()
  171. ```
  172. ### Java Client
  173. ```java
  174. var bro = Vibium.start();
  175. var vibe = bro.page();
  176. vibe.go("https://example.com");
  177. var png = vibe.screenshot();
  178. Files.write(Path.of("screenshot.png"), png);
  179. var link = vibe.find(new SelectorOptions().css("a"));
  180. link.click();
  181. bro.stop();
  182. ```
  183. ---
  184. ## Architecture
  185. ```
  186. ┌──────────────────────────────────────┐
  187. │ LLM / Agent │
  188. │ (Claude Code, Codex, Gemini, etc.) │
  189. └──────────────────────────────────────┘
  190. ▲ ▲
  191. │ CLI (Bash) │ MCP (stdio)
  192. ▼ ▼
  193. ┌───────────────────────────────────┐
  194. │ Vibium binary │
  195. │ │
  196. │ ┌──────────────┐ ┌────────────┐ │
  197. │ │ CLI Commands │ │ MCP Server │ │
  198. │ └─────┬────────┘ └──────┬─────┘ │ ┌──────────────────┐
  199. │ └───────▲─────────┘ │ │ │
  200. │ │ │ │ │
  201. │ ┌──────▼───────┐ │ BiDi │ Web Browser │
  202. │ │ BiDi Proxy │ │◄──────►│ │
  203. │ └──────────────┘ │ │ │
  204. └───────────────────────────────────┘ └──────────────────┘
  205. ▲
  206. │ WebSocket BiDi :9515
  207. ▼
  208. ┌──────────────────────────────────────┐
  209. │ Client Libraries │
  210. │ (js/ts | python | java) │
  211. │ │
  212. │ ┌─────────────────┐ ┌────────────┐ │
  213. │ │ Async API │ │ Sync API │ │
  214. │ │ await vibe.go() │ │ vibe.go() │ │
  215. │ └─────────────────┘ └────────────┘ │
  216. └──────────────────────────────────────┘
  217. ```
  218. ---
  219. ## Platform Support
  220. | Platform | Architecture | Status |
  221. |----------|--------------|--------|
  222. | Linux | x64 | ✅ Supported |
  223. | Linux | arm64 | ✅ Supported |
  224. | macOS | x64 (Intel) | ✅ Supported |
  225. | macOS | arm64 (Apple Silicon) | ✅ Supported |
  226. | Windows | x64 | ✅ Supported |
  227. 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).
  228. ---
  229. ## Contributing
  230. See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
  231. Source builds require Go, Node.js/npm, and Java 21 because the default `make`
  232. target builds the Go binary, JS client, and Java client.
  233. ---
  234. ## What's next
  235. There is no single roadmap. Feature requests and bugs are in the
  236. [issues](https://github.com/VibiumDev/vibium/issues). Designs are in
  237. [docs/specs](docs/specs/), and not every one will be built. Related work
  238. happens in [Vibium Station](https://github.com/VibiumDev/station),
  239. [Roadie](https://github.com/VibiumDev/roadie) and the
  240. [Record Player](https://github.com/VibiumDev/record-player).
  241. ---
  242. ## License
  243. Apache 2.0

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.