Repository navigation
Releases
Releases · YXZYSME/mimikyu
mimikyu v0.1.0
Added
- Dual-Engine Native Rust Browser Runtime (
mimikyu-core):- Unified
DriverSessionabstraction driving local Chromium via native WebSocket DevTools Protocol (driver::cdp) and Firefox / Gecko via W3C WebDriver BiDi (driver::bidi). - Automatic local browser discovery across explicit path overrides,
MIMIKYU_CHROMIUM_PATH/MIMIKYU_FIREFOX_PATH, Playwright/Puppeteer caches, system bundles, andPATH.
- Unified
- Two-Tier Session & Profile Isolation (
isolation):- Tier 1 (Process & Disk Profile): Exclusive
fs2-locked persistent profiles (--profile), self-cleaning ephemeral directories (--ephemeral), and portable JSON cookie/storage export and import (session export/import,profile export/import). - Tier 2 (Virtual Browser Contexts): Warm pooled lightweight contexts (
--virtual/VirtualContextPool) for low-latency concurrent agent sessions.
- Tier 1 (Process & Disk Profile): Exclusive
- Camoufox-Inspired Environment Consistency (
env_profile):- Built-in
win11,macos, andlinuxOS environment presets with cross-checked User-Agent, platform, screen/viewport, locale, and timezone coherence validation. - Synchronized window, Worker, and SharedWorker initialization script injection.
- Offline GeoIP timezone/locale derivation (
--geoip) and loopbackProxyRelay(127.0.0.1:0) supporting upstream HTTP and SOCKS5 authentication without exposing credentials on browser command lines.
- Built-in
- Token-Efficient Agentic Browser Primitives (
snapshot,extract,wait,input):- Compact semantic accessibility tree snapshots (
mimikyu snapshot) with deterministic@eNelement refs across open Shadow DOM and same-origin/nested/cross-origin iframes, plus--interactive-only,--max-depth,--include-bounds, and structural--diff. - Structured page extraction (
markdown,text,links,tables), PNG screenshots (viewport,--full-page,--target), PDF export (mimikyu pdf), and--instant-animations. - Deterministic readiness waits (
--idlecombining lifecycle + network quiet + layout stability,--text,--url, and--selector --state). - Serialized
ChokepointInputboundary with optional--humanizekinematic pointer trajectories, typing cadence variance, split wheel notches, and single-round-tripActionBatcher(mimikyu batch).
- Compact semantic accessibility tree snapshots (
- Network Resource Control & Telemetry (
network):- Per-session resource blocking (
--block-images,--block-media,--block-fonts), request interception/routing, and bounded ring-buffer console/network logs (mimikyu logs).
- Per-session resource blocking (
- Warm Daemon, Unified CLI & 31-Tool MCP Server (
daemon,mcp,mimikyu-cli):- Warm Unix-socket NDJSON background daemon with auto-spawn, configurable idle timeout, and automatic
/tmp/mkd-<sha256>.socksymlinking when state paths approachSUN_LEN. - Unified
mimikyuCLI supporting--jsonstructured envelopes across all subcommands and--no-daemondirect execution. - Stateful stdio JSON-RPC 2.0 MCP server (
protocolVersion = "2024-11-05") exposing 11mimikyu_*and 20browser_*tools.
- Warm Unix-socket NDJSON background daemon with auto-spawn, configurable idle timeout, and automatic
- Reproducible Offline Benchmark & Verification Suites (
harness,bench,e2e):- Embedded
127.0.0.1:0dual-origin HTTP benchmark server andmimikyu benchCLI measuring cold launch, warm virtual context creation, navigation,@eNsnapshot latency (~5.0 ms median on Chromium), token compression ratio, live process-tree RSS, and 5 end-to-end agentic workflows across Chromium and Firefox. - Standalone 244-test opaque-box Python 3 stdlib E2E verification suite (
e2e/run_e2e.py) across Tiers 1–4 and--self-test.
- Embedded
Security & Host Reliability
- Isolated-World Evaluation by Default:
mimikyu evalexecutes JavaScript inside an isolated execution world unless--main-worldis explicitly requested. - macOS Zero-Spawn Firefox Probe & Crash Suppression: Reads
application.iniandContents/Info.plistdirectly from disk (avoidingfirefox --versionexit races on macOS) and launches Firefox withMOZ_CRASHREPORTER_DISABLE=1,MOZ_CRASHREPORTER=0, andMOZ_CRASHREPORTER_NO_REPORT=1. - Deterministic Process-Group Reaping: Isolates every spawned browser in its own POSIX process group (
setpgid(0, 0)) with graceful protocol close followed by deterministic process-group cleanup on shutdown, signal, orDrop.
Install or Update (v0.1.0)
# Fresh install
curl -fsSL https://raw.githubusercontent.com/YXZYSME/mimikyu/v0.1.0/install.sh | MIMIKYU_REPO=YXZYSME/mimikyu sh -s -- --version v0.1.0
# Upgrade an existing installation
curl -fsSL https://raw.githubusercontent.com/YXZYSME/mimikyu/main/install.sh | MIMIKYU_REPO=YXZYSME/mimikyu sh -s -- --update
# Verify GitHub SLSA Artifact Attestation (optional, requires gh >= 2.49)
gh attestation verify mimikyu-<target>.tar.gz --repo YXZYSME/mimikyu