Sub-5ms Native Rust Browser Runtime for AI Agents
mimikyu by Saengil is a single-binary native Rust browser runtime, two-tier session & profile isolation layer, warm Unix-socket daemon, and 31-tool MCP control plane driving local Chromium (CDP) and Firefox (W3C WebDriver BiDi) — with zero Node.js or Python runtime overhead.
Compresses open Shadow DOM & cross-origin iframes into deterministic @e1, @e2 refs in single-digit milliseconds.
$ curl -fsSL https://raw.githubusercontent.com/YXZYSME/mimikyu/main/install.sh | sh01 // INSTALL EVERYWHERE
Six Official Ecosystems, One Native Binary
Install via Shell, Homebrew, crates.io, npm (saengil-mimikyu), PyPI, or drop straight into any MCP 2024-11-05 host with zero global install.
curl -fsSL https://raw.githubusercontent.com/YXZYSME/mimikyu/main/install.sh | shDownloads the prebuilt native Rust binary, verifies SHA256SUMS before extraction, and installs atomically to ~/.local/bin.
02 // MEASURED LOCAL BENCHMARKS
Chromium CDP vs Firefox WebDriver BiDi
Real release numbers captured offline against the embedded 127.0.0.1:0 dual-origin harness — zero external network jitter.
$ mimikyu bench --iterations 3 --warmup 1 --suite allMulti-step wizard flow
Form echo & validation
Catalog filter + structural diff + table extraction
Dynamic DOM hydration + atomic batch
Open Shadow DOM + nested/cross-origin iframes
03 // MCP 2024-11-05 CONTROL PLANE
Interactive 31-Tool MCP Reference Explorer
Search, filter by namespace (mimikyu_* or browser_*), inspect exact parameter schemas extracted from Rust source, and copy JSON-RPC 2.0 payloads in one click.
| Parameter | Type | Requirement | Description |
|---|---|---|---|
| session | string | optional | Session identifier (defaults to 'default') |
| diff | boolean | optional | Include structural diff from the previous snapshot |
| max_depth | integer(≥0) | optional | Maximum tree traversal depth |
| interactive_only | boolean | optional | Keep only interactive elements and ancestors |
| include_bounds | boolean | optional | Resolve bounding boxes for interactive refs |
crates/mimikyu-core/src/mcp/tools.rs04 // RUNTIME TOPOLOGY & R3 SECURITY BOUNDARY
Deterministic Architecture, Zero Leak Surface
Strict General-Purpose Automation Scope — Hardened by Default
mimikyu intentionally excludes any CAPTCHA solver, human-verification bypass, proof-of-work cracker, or anti-bot gate circumvention across bothcrates/ and e2e/.
Authenticated HTTP and SOCKS5 upstream proxies terminate in a local127.0.0.1:0 relay so credentials never appear inps process arguments or browser profiles.
mimikyu eval defaults to an isolated JS world (explicit--main-world opt-in), with zero-spawn macOS Firefox metadata probes and setpgid(0, 0) zero-orphan reaping.
05 // ZERO-DRIFT DOCUMENTATION HUB
Rendered Live from Repo Root at Build Time
Every specification below is read directly from the canonical Markdown files in the repository root — zero duplicated copies, zero doc drift.
Architecture & Scaling Invariants
Workspace module graph, DriverSession CDP/BiDi boundary, ChokepointInput serialization, and the five non-negotiable invariants.
Security Policy & R3 Boundary
Private vulnerability disclosure, Unix-socket & ProxyRelay credential isolation, sandboxed eval, and strict R3 compliance boundaries.
Release & Version Control
SemVer 2.0.0 workspace sync, trunk-based branching, SLSA v1 provenance attestations, and install.sh --update lifecycle.
Changelog
Keep-a-Changelog release history covering dual-engine drivers, two-tier isolation, @eN snapshots, and 31 MCP tools.
Contributing Guide
Local Rust 1.88+ setup, Conventional Commits, narrow vertical PR rules, and the pre-PR Clippy + Rust + E2E verification gauntlet.