mimikyu pixel mascot
mimikyuby Saengil
mimikyu — 16-bit pixel-art banner featuring an original rag-disguise browser sprite mascot, MIMIKYU logo, and runtime HUD
AGENTDEX // ENTRY NO. 031v0.1.0 · RUST 1.88+ (EDITION 2024)MIT OR Apache-2.0

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.

mimikyu rag-disguise browser sprite mascot
TYPE: SHADOW / BROWSER

Compresses open Shadow DOM & cross-origin iframes into deterministic @e1, @e2 refs in single-digit milliseconds.

337 Rust + 244 E2E Tests Passing
5.0 ms
Semantic @eN Snapshots
Chromium CDP · 19.0 ms BiDi
2.8×–3.6×
Token Compression
967 → 271–347 est. tokens
31 Tools
Stdio MCP Server
11 mimikyu_* · 20 browser_*
CDP + BiDi
Dual Native Drivers
Local Chromium & Firefox
1-Line POSIX Install · SHA-256 + SLSA v1 Verified
$ curl -fsSL https://raw.githubusercontent.com/YXZYSME/mimikyu/main/install.sh | sh
LIVE CDP SCREENCAST · GitHub, crates.io, PyPI & Hacker News (Zero Overlays)

01 // 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.

SHA256SUMS + SLSA v1 Provenance
SHA-256 + SLSA v1GitHub Releases ↗
curl -fsSL https://raw.githubusercontent.com/YXZYSME/mimikyu/main/install.sh | sh

Downloads 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.

337 Rust Tests244 Python E2E
Chromium (WebSocket CDP)Firefox (W3C WebDriver BiDi)
Median · 5/5 agentic workflows (100%)
Semantic @eN snapshotCompact accessibility tree + Shadow DOM & iframe refs
CDP 5.0 ms/BiDi 19.0 ms
CDP
BiDi
Markdown extractionStructured Markdown distillation from live DOM
CDP 5.4 ms/BiDi 5.5 ms
CDP
BiDi
Warm virtual contextTier 2 isolated VirtualContextPool allocation
CDP 67.1 ms/BiDi 124.2 ms
CDP
BiDi
Atomic 3-step batchFill + click + wait in a single daemon round trip
CDP 204.2 ms/BiDi 203.5 ms
CDP
BiDi
Navigation + idle waitPage load + network quiet + layout stability
CDP 276.9 ms/BiDi 286.7 ms
CDP
BiDi
Cold ephemeral launchTier 1 full process launch + isolated temp profile
CDP 203.0 ms/BiDi 1179.3 ms
CDP
BiDi
Reproduce Locally (127.0.0.1:0 dual-origin local HTTP harness (offline, reproducible))
$ mimikyu bench --iterations 3 --warmup 1 --suite all
5 / 5 End-to-End Agentic Benchmark Workflows Passing (Chromium + Firefox)0 Clippy Warnings · 0 Orphan Processes · 0 R3 Violations
W1 ✓

Multi-step wizard flow

W2 ✓

Form echo & validation

W3 ✓

Catalog filter + structural diff + table extraction

W4 ✓

Dynamic DOM hydration + atomic batch

W5 ✓

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.

MCP Registry ↗
Showing 33 of 33 stdio JSON-RPC 2.0 toolsProtocol 2024-11-05 · Registry: io.github.YXZYSME/mimikyu
ParameterTypeRequirementDescription
sessionstringoptionalSession identifier (defaults to 'default')
diffbooleanoptionalInclude structural diff from the previous snapshot
max_depthinteger(≥0)optionalMaximum tree traversal depth
interactive_onlybooleanoptionalKeep only interactive elements and ancestors
include_boundsbooleanoptionalResolve bounding boxes for interactive refs
Extracted directly from crates/mimikyu-core/src/mcp/tools.rs

04 // RUNTIME TOPOLOGY & R3 SECURITY BOUNDARY

Deterministic Architecture, Zero Leak Surface

Read ARCHITECTURE.md →
CONTROL PLANE DATAFLOWCLI/MCP → Unix Daemon → Tier 1/2 Isolation → Local ProxyRelay → CDP / BiDi
1. FRONTENDSmimikyu CLI--json envelopebatch · snapshotmimikyu mcpStdio JSON-RPC 2.031 MCP tools2. UNIX DAEMONdaemon.sockNDJSON RPC · 0600SessionManagerChokepointInput@eN Snapshot + DiffAuto-spawn & Idle ReapZero Node / Python3. TIER 1 / 2 ISOLATIONTier 1 · Process/Diskfs2 locked --profileor --ephemeral tempdirTier 2 · Virtual Pool--virtual contexts67.1 ms warm alloc4. PROXY & ENVLocal ProxyRelay127.0.0.1:0 loopbackAuth HTTP/SOCKS5Zero CLI cred leaksEnv Coherencewin11 | macos | linuxOffline GeoIPResource BlockerChromiumNative WebSocket CDP5.0 ms snapshotsetpgid(0, 0) reapedFirefox / GeckoW3C WebDriver BiDi3.57× token ratioZero-spawn discoveryINVARIANT: Zero raw CDP/BiDi protocol types leak above DriverSession · Graceful Browser.close + POSIX process-group teardown
■R3 Security & Privacy Boundary

Strict General-Purpose Automation Scope — Hardened by Default

Read SECURITY.md →
Zero Anti-Bot / CAPTCHA Bypass

mimikyu intentionally excludes any CAPTCHA solver, human-verification bypass, proof-of-work cracker, or anti-bot gate circumvention across bothcrates/ and e2e/.

Loopback ProxyRelay Credential Isolation

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.

Sandboxed World & Process Hygiene

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.

Open Docs Hub →