# vibatchium [Health: Active]

**Category:** 📂 Browser Automation  
**Repository:** https://github.com/trueoriginlabs/vibatchium  
**GitHub Stars:** 9  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/vibatchium

## Description
Patchright stealth + Vibium-style LLM-friendly CLI for agentic browser automation.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "vibatchium": {
    "command": "uvx",
    "args": ["vibatchium"]
  }
}
```

## Documentation

## What vibatchium does

vibatchium combines a `vb` command-line interface, an MCP server, and a daemon that manages persistent Chrome sessions. Each session has its own Chrome process and profile, allowing multiple logged-in identities to stay available at the same time. Sessions can also have separate proxies, time zones, and GPU nodes; optional persona settings can configure screen and window characteristics.

The project targets unattended browser automation rather than a single supervised browser. It includes crash relaunch on the same profile, renderer parking for idle sessions, leases to prevent concurrent agents from colliding, and task goals with step, spending, and time budgets that survive a daemon restart.

## How it works

Install the Python package, install Chrome through Patchright, and use `vb setup` to register the MCP server and agent skill. The MCP entry point is `vb mcp`. Agents then operate named sessions while the daemon keeps those sessions alive. The command line also supports direct operations such as starting a session, navigating to a URL, performing an action, extracting content, and checking how similar fleet sessions appear.

A separate browserless path reuses a session's cookies and proxy for HTTP requests. `vb fetch` uses Chrome's TLS fingerprint and client hints, while `vb search` can find URLs without an API key or a per-session budget. Fetch reports when a request cannot match the browser context.

## Setup and configuration

The core package can be installed with pipx:

```text
pipx install vibatchium
pipx install 'vibatchium[all]'
patchright install chrome
vb setup
```

The `all` extra adds the fetch and search lanes, credential vault, VLM reading, and REST shim. Individual extras include `fetch`, `secrets`, `llm`, and `rest`. A uv-based environment can add optional packages with `uv pip install --python <venv>/bin/python ...`.

`vb setup` is idempotent and configures the local agent integration. The skill can also be installed with `npx skills add trueoriginlabs/vibatchium`; the documented integrations include Claude Code, Codex, Cursor, and Gemini CLI. On Claude Code, use either the plugin or `vb setup`, not both, to avoid registering the MCP server twice.

## Tools and capabilities

- Manage multiple persistent, parallel Chrome sessions on one daemon.
- Browse pages, extract content, take screenshots, and perform natural-language actions.
- Store passwords and TOTP seeds in a vault, then fill them into the matching origin without returning the secret to the model, screenshot, or log.
- Scan returned page text for instructions aimed at the agent, with options to fence or redact detected content.
- Restrict caller-supplied file paths to reduce unintended uploads or writes.
- Reuse session cookies and proxy settings for browserless HTTP requests.
- Search for URLs without an API key.
- Apply session leases, idle renderer freezing, crash recovery, and task budgets.

## Limitations and notes

vibatchium is described as alpha software under active development. Its tested environment is Linux with Python 3.11 through 3.14; macOS is identified as unsupported in the platform comparison. The stealth layer operates at the CDP level through Patchright, rather than modifying Chromium's C++ engine.

The credential boundary applies to MCP use. An operator with shell access can use the CLI's deliberate escape hatches, so agents should receive MCP access rather than Bash when preventing secret disclosure matters. The email-code polling command is an operator CLI feature and is refused over MCP.

Stealth detector results are manual observations rather than CI-gated guarantees. The project is self-hosted and licensed under Apache-2.0.

_Full upstream README: https://allmcps.com/mcp/vibatchium/readme_