Canonical source:
CHANGELOG.md~4 min readChangelog
All notable changes to mimikyu will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Unreleased
[0.2.0] - 2026-11-20
Added
- Managed Browser Installer & Discovery (
mimikyu browser):- Added
DiscoverySource::MimikyuManaged(<data_local_dir>/mimikyu/browsers/, overridable viaMIMIKYU_BROWSERS_DIR, prioritized right afterEnvOverride). - Added
mimikyu browser {list, path, install [--dry-run] [--version] [--sha256]}resolving official Chrome-for-Testing and Firefox release artifacts with SHA-256 verification.
- Added
- Hardened Privacy Vault Mode & Tracker Blocklist (
mimikyu vault,--block-trackers,--privacy-mode):- Added curated DNS-boundary tracker/analytics domain blocklist preset (
--block-trackers) across both Chromium CDP and Firefox WebDriver BiDi. - Added
mimikyu vault {launch, list}withfs2-locked persistent profiles, headed defaults, WebRTC IP-leak protection, Firefox privacy preferences, and human-safe interactive Chromium flags while preserving zero telemetry andProxyRelayisolation.
- Added curated DNS-boundary tracker/analytics domain blocklist preset (
- R3-Compliant Human-in-the-Loop (HITL) Session Takeover (33 MCP Tools):
- Added
session pause,session resume, andsession takeovergating automated input mutations while a human interacts legitimately, invalidating stale@eNsnapshot refs on resume. - Added MCP tools
mimikyu_request_human_takeoverandmimikyu_resume_from_human(expanding the MCP surface from 31 to 33 tools).
- Added
- Headless CDP Screencast Frame Recording (
mimikyu record) & Demo Pipelines:- Added engine-agnostic
DriverSession::{start_screencast, stop_screencast}implemented over CDPPage.startScreencast/Page.screencastFrameAckand exposed viamimikyu record {start, stop}. - Added
scripts/demos/record_raw_live.py(100% raw unstylized live-website browser capture) andscripts/demos/record_demos.py(offline reproducible showcase demos).
- Added engine-agnostic
- Multi-Ecosystem Publishing, Website (
mimikyu.saengil.ai) & IP Attribution:- Added top-level
crates/mimikyufacade crate (crates.io),saengil-mimikyu/mimikyu-cli/mimikyu-mcp(npm),mimikyuuniversal wheel/sdist (PyPI),server.json(Official MCP Registryio.github.YXZYSME/mimikyu), and zero-token GitHub OIDC publishing across all registries in.github/workflows/release.yml. - Added Astro 7 + Tailwind CSS v4 + Preact Islands showcase & docs site (
website/, zeronpm auditvulnerabilities) deployed via.github/workflows/pages.ymlforhttps://mimikyu.saengil.ai. - Added Apache-2.0 Section 4(d)
NOTICE(bundled into release tarballs) andCITATION.cff.
- Added top-level
Changed
- Updated
README.mdimage URLs to absoluteraw.githubusercontent.compaths so pixel-art branding renders cleanly oncrates.io,npm, andPyPI, and embedded livev0.2.0demo previews.
0.1.0 - 2026-11-19
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
- 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.