Vibium CLI
Один бинарник для автоматизации браузера агентом: CLI со скиллами browser и check, MCP-сервер и клиенты для JS, Python и Java
- 2 937 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Управляет браузером: кликает, заполняет формы и может выполнить JavaScript на странице через `eval`
- Команды `run` и `check` отправляют содержимое страниц внешнему провайдеру модели по ключу из `~/.config/vibium/ai.env`
- Установка скачивает Chrome и бинарник, а `vibium setup` пишет файлы в каталоги скиллов агента
Установка
- Работает в
Ручная установка
npm install -g vibium && vibium setupМастер установит Chrome, если его нет, и предложит выбрать скиллы browser и check. Агентам доступен режим vibium setup --non-interactive.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Управляет браузером: кликает, заполняет формы и может выполнить JavaScript на странице через `eval`
- Команды `run` и `check` отправляют содержимое страниц внешнему провайдеру модели по ключу из `~/.config/vibium/ai.env`
- Установка скачивает Chrome и бинарник, а `vibium setup` пишет файлы в каталоги скиллов агента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Vibium дает агенту средства проверить собственную работу в браузере. Команда `vibium go` открывает страницу, `vibium map` нумерует интерактивные элементы метками `@e1`, `@e2`, и по этим меткам агент кликает, заполняет поля и выбирает пункты списков. Есть чтение текста, скриншоты (в том числе с подписанными элементами), выгрузка в PDF, ожидание элемента или адреса и запись сессии в архив. Два скилла, `browser` и `check`, подключают это к агенту: первый ведет по страницам и действиям, второй независимо проверяет утверждение вроде «в корзине ровно один аккумулятор» и сохраняет запись. Тот же бинарник работает как MCP-сервер, а для кода есть клиентские библиотеки. Построен на WebDriver BiDi, по умолчанию запускает Chrome, Firefox включается флагом.
Для кого. Для разработчиков и тестировщиков, которые поручают Claude Code, Codex или Gemini CLI веб-интерфейс и хотят, чтобы результат проверялся в живом браузере.
Подходит, если
- Агент сверстал форму, и вы просите его самому пройти сценарий в браузере: заполнить поля, нажать кнопки, снять скриншот
- Нужно независимо подтвердить, что утверждение выполнено, например что после добавления товара в корзине один экземпляр, и сохранить запись проверки в zip
- Сайт часто меняет верстку, и вам нужны семантические поиски без CSS: `vibium find text`, `find label`, `find role button`
- Вы хотите единый инструмент и для агента, и для тестов: тот же бинарник отдает MCP-сервер, а клиент ставится через npm, pip или Maven
- Нужно сравнить состояние страницы до и после действия: команда `vibium diff map` показывает, что поменялось
Не подходит, если
- Нужна только статическая выборка текста со страницы без браузера: запуск Chrome будет лишним
- Нужны команды `run` и `check` без настройки модели: им требуется ключ провайдера и файл `~/.config/vibium/ai.env`, а сейчас они работают только на сборке для разработки
- Нужен браузер с готовыми входами и расширениями пользователя: Vibium запускает отдельный браузер
- Вы работаете на Linux arm64 или другой платформе вне списка: заявлены Linux x64, macOS x64 и arm64, Windows x64
Пример запроса к агенту
Через vibium открой localhost:3000, добавь в корзину один товар и проверь командой check, что в корзине ровно одна позицияОграничения
Команды `vibium run` и `vibium check` вызывают модель, поэтому им нужны провайдер и ключ в `~/.config/vibium/ai.env`: поддерживаются openai, xai, anthropic, google, openai-compatible и local. На момент выхода документации они работают только на сборке для разработки. API OpenAI и Anthropic из России без VPN недоступны, но можно указать провайдера local или свой адрес openai-compatible. Остальные команды ключей не требуют. Заявлены платформы Linux x64, macOS x64 и arm64, Windows x64. Для сборки из исходников нужны Go, Node.js и Java 21.
Как отключить. Закройте браузер командой `vibium stop`. Глобальный пакет снимает `npm uninstall -g vibium`. Скиллы browser и check удалите из каталога скиллов агента, а запись MCP — командой `claude mcp remove vibium`. Файл `~/.config/vibium/ai.env` с ключами удалите вручную.
Частые вопросы
Как поставить Vibium в Claude Code?
Выполните `npm install -g vibium`, затем `vibium setup`: мастер предложит выбрать скиллы browser и check, агента и область установки, а недостающий Chrome скачает сам. Вариант через MCP: `claude mcp add vibium -- npx -y vibium mcp`.
Чем скилл check отличается от run?
`run` отдает модели браузерную цель, например добавить товар в корзину. `check` независимо оценивает утверждение в браузере или на записи и возвращает вердикт. Автор требует звать check отдельно: статус completed у run и ваши наблюдения его не заменяют.
Что такое метки @e1 в Vibium?
Команда `vibium map` перечисляет интерактивные элементы страницы и присваивает им ссылки `@e1`, `@e2` и так далее. Дальше команды `click`, `fill`, `select` принимают такую ссылку. После перехода или изменения страницы ссылки нужно получить заново повторным `vibium map`.
Можно ли использовать Vibium из Python или Java?
Да. Клиенты ставятся как `npm install vibium`, `pip install vibium` и зависимость com.vibium:vibium в Gradle или Maven. Для JavaScript есть асинхронный и синхронный API, оба скачивают Chrome автоматически.
Работает ли Vibium с Firefox?
Да, Chrome выбран по умолчанию, а Firefox включается флагом `--engine firefox`. Запись видео сессии заявлена для Firefox 154 и новее.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер, который запускает несколько браузерных агентов и проверяет сайт на битые ссылки, ошибки интерфейса и доступность
MCP-сервер от Mozilla: агент управляет Firefox через WebDriver BiDi, читает консоль и сеть, делает снимки страниц и профилирует загрузку
CLI, MCP-сервер и типизированный Node.js API, чтобы агент проверял свои правки в живом мобильном приложении на iOS, Android и других платформах
Скилл проверки кода агента в настоящем браузере: читает ваши изменения, составляет план теста и прогоняет его через Playwright с вашими куки
Playwright CLI
playwright-cli
Официальный CLI Playwright со скиллом для агентов: управление браузером короткими командами без тяжелых MCP-схем
Самообучающийся QA-агент: тесты для веба и мобильных на естественном языке, которые сами чинятся и запоминают прогоны
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Vibium (эта запись) | нет | 2 937 | ||
| Playwright CLI | да | 14 523 | CLI Playwright со скиллом, у Vibium отдельный независимый вердикт check и запись проверки | |
| dev-browser | нет | 6 689 | управляет Chrome короткими скриптами Puppeteer, Vibium работает командами с метками элементов и на WebDriver BiDi | |
| Chrome DevTools MCP | да | не нужна | 54 001 | официальный MCP-сервер Chrome DevTools с упором на сеть и трейсы, Vibium шире по форме: CLI, скиллы, MCP и клиенты |
Коротко о README
README представляет Vibium как слой проверки для кодирующих агентов, не требующий настройки: один бинарник около 10 МБ без зависимостей, на стандарте WebDriver BiDi. Раздел Agent Setup описывает установку и два скилла, а затем шпаргалка перечисляет команды: постановка задачи через `run`, проверка через `check`, карта элементов, поиск по тексту, метке и роли, чтение, ожидание, запись и формы. Дальше показан MCP-вариант, затем клиенты на JS и TS, Python и Java в синхронном и асинхронном вариантах. Завершают схема архитектуры, таблица платформ, ссылки на руководства и лицензия Apache 2.0.
Бейдж для README
Исходный SKILL.md
--- name: browser description: Automate browsers with the Vibium CLI. Use to navigate websites, inspect pages, fill forms, extract page data, debug UI behavior, capture screenshots and recordings, or delegate browser goals with vibium run. --- # Vibium Browser Automation — CLI Reference The `vibium` CLI automates Chrome (and Firefox, via `--engine firefox`) from the command line. The browser auto-launches on first use (daemon mode keeps it running between commands). Use this skill for browser automation, exploration, debugging, and recording. Choose explicit CLI commands when you know the steps, or use `vibium run` when a model should work out how to accomplish a browser goal. For an independent acceptance verdict, use the `check` skill if installed, or `vibium check "<claim>"`. Run’s `completed` result and your own browser observations do not substitute for that invocation. ## Core Workflow For direct browser commands, use this pattern: 1. **Navigate**: `vibium go <url>` 2. **Map**: `vibium map` (get element refs like `@e1`, `@e2`) 3. **Interact**: Use refs to click, fill, select — e.g. `vibium click @e1` 4. **Re-map**: After navigation or DOM changes, get fresh refs with `vibium map` ## Binary Resolution Before running any commands, resolve the `vibium` binary path once: 1. Try `vibium` directly (works if globally installed via `npm install -g vibium`) 2. Fall back to `./clicker/bin/vibium` (dev environment, in project root) 3. Fall back to `./node_modules/.bin/vibium` (local npm install) Run `vibium --help` (or the resolved path) to confirm. Use the resolved path for all subsequent commands. **Windows note:** Use forward slashes in paths (e.g. `./clicker/bin/vibium.exe`) and quote paths containing spaces. ## Browser readiness During initial setup, run `vibium ready browser --json` with the engine/channel that the workflow will use. It inspects installed browser and driver files without launching them or touching existing sessions. Passing confirms the installation, not browser launch or BiDi connectivity. If installation is missing, use the reported `vibium install` command and retry. Direct browser work does not need AI configuration. Do not rerun readiness before every action when setup is unchanged. ## Delegate a browser goal with Run Use `vibium run "<goal>"` when the task is clear but the sequence of browser