v0.8.0
Ghostlight v0.8.0 -- governed browser automation for AI agents.
A native Rust service, protocol-versioned MCP edge, and thin Chromium adapter that give an AI
agent controlled access to your real, authenticated browser session, with an opt-in governance
layer (capability grants, sacred domains, audit). See the README and docs/guides/ for the
full walkthrough.
What's changed
The v0.8.0 candidate makes the MCP edge explicitly protocol-versioned, leaves the service kernel
protocol-neutral, and makes browser tab continuity match what users see in Chrome.
Added
- MCP 2026-07-28 support (ADR-0096). The local stdio edge implements the 2026 discovery and
request-metadata lifecycle alongside MCP 2025-11-25. The protocol-neutral service does not parse
MCP JSON-RPC or retain MCP request ids. - Local MCPB packaging (ADR-0095). Release assembly now produces a self-contained Claude
Desktop package with the same local-only service and Chrome Web Store adapter boundary. - Browser-created tab continuity (ADR-0099). Opted-in browser results report a bounded tab
delta. The service validates and claims a still-open child before returning its composite tab id,
so an agent can use that id immediately without a separate context refresh.
Changed
- Three explicit executable roles (ADR-0096). MCP clients launch
ghostlight-mcp-connector, the persistent protocol-neutral service remainsghostlight, and
Chromium launchesghostlight-browser-connector. The old dual-roleghostlight-relaypath is
removed rather than retained as a compatibility alias. - Extension-owned Chrome topology (ADR-0098). The extension owns native Chrome window, group,
and placement mechanism. The service sends only logical workspace authority and presentation
intent, so user-moved tabs and groups stay where the user put them. - Major/minor adapter contract (ADR-0093). Chrome adapter v0.8.0 covers every Ghostlight
service v0.8.x patch. Compatible adapter and service patches can ship independently; a contract
change advances the minor for both components. - Exact-title tab groups are reused for presentation without merging workspace authority or tab
inventories.
Fixed
- A browser-created child with one exact managed opener is passively adopted into that workspace,
while guessed, ambiguous, and cross-workspace tabs remain inaccessible. - Closed MCP transports now tell the agent to reconnect through its current client instead of
spawning a standalone connector that creates a different workspace and duplicate browser tabs. - Moving a managed tab or whole group into another Chrome window no longer causes context lookup
or addressed navigation to create replacement tabs or groups.
Install
- Install the service and register detected MCP clients:
npx -y ghostlight install. - Install Ghostlight in Browser
from the Chrome Web Store. - Restart your MCP client, then verify the whole chain with
npx ghostlight doctor.
Each platform archive contains the persistent ghostlight service, the protocol-versioned
ghostlight-mcp-connector stdio edge, and the browser-only ghostlight-browser-connector native host. MCP clients
must start ghostlight-mcp-connector; the removed ghostlight-relay --role agent path is not a fallback.
End-to-end verified on Windows and Linux. macOS builds and passes the full test suite in CI;
live-browser verification there is still owed.
Verify
Every archive carries a signed build-provenance attestation (GitHub Artifact
Attestations / Sigstore). Prove an artifact was built by this repo's release workflow,
not a mirror or a tampered copy:
gh attestation verify <archive> --repo sylin-org/ghostlight
The SHA-256 checksums are below (the attestation is the stronger, signed check).
Downloads
| Platform | Architecture | Download |
|---|---|---|
| Windows | x86_64 | ghostlight-v0.8.0-x86_64-pc-windows-msvc.zip |
| macOS | Apple Silicon | ghostlight-v0.8.0-aarch64-apple-darwin.tar.gz |
| macOS | Intel | ghostlight-v0.8.0-x86_64-apple-darwin.tar.gz |
| Linux | x86_64 | ghostlight-v0.8.0-x86_64-unknown-linux-gnu.tar.gz |
| Chrome adapter | any | ghostlight-extension-v0.8.0.zip |
| Claude Desktop MCPB | Windows/macOS | ghostlight-v0.8.0.mcpb |
Checksums (SHA-256)
35b8c021c8e355aacfe8150f857c42d36fcf9c94501d59241e2e079fc7540a95 ghostlight-aarch64-apple-darwin
b2a8ab63fda70f0ce0bbaa103a3d90a80352e79203506688cd200ab795376c6c ghostlight-aarch64-apple-darwin.sha256
1f1e9f495238a811cfaac3b9e41534a01062f7bfe06d6c94e88501d850ff83b7 ghostlight-browser-connector-aarch64-apple-darwin
d537de27637914a5c4740a91c27cbca5a3c7b84cafbe23d0a548c1393d6ec926 ghostlight-browser-connector-aarch64-apple-darwin.sha256
81ae194b8dce2116f6af996e417045fb25c7139989c0cb2d6973b282a2d0a767 ghostlight-browser-connector-x86_64-apple-darwin
7c08d33a39f72d3f668306846f8f3c44eb1cabcfa6cc65a496c6bedb7c469894 ghostlight-browser-connector-x86_64-apple-darwin.sha256
624fa5f4b92adb8648ee0824e974e480d4e6c4d169f6c025a8900f059d9cf3ae ghostlight-browser-connector-x86_64-pc-windows-msvc.exe
74857b27af1637be520c958f45d2b7631326f74fd673ddda513f1a101618ff70 ghostlight-browser-connector-x86_64-pc-windows-msvc.exe.sha256
72b0fe1e8b454c455bc366abab3506972e98d12514dcacb8be2518b28f26098e ghostlight-browser-connector-x86_64-unknown-linux-gnu
29966da055674af6f6625c72507a154bdbdbde64e36a8ab1ac6ef631f1312cbe ghostlight-browser-connector-x86_64-unknown-linux-gnu.sha256
9c7f16feaa0a7f068b440af107463162f8f467229f3daab8ad2f4f759bc9dfae ghostlight-extension-v0.8.0.zip
f41fd52f493d88ebc73417dcadf642eb4a4dc7ca8a131cfe5ffe8d4d9800337c ghostlight-extension-v0.8.0.zip.sha256
61029bafbbc8de89cd66d59d3fa83f1485669b1784d68ca094bcb2ab08b3b431 ghostlight-mcp-connector-aarch64-apple-darwin
d44836c7bdec039ef57403ba526234c4428b3fc7c4475aa7ffbb3669dc343f9e ghostlight-mcp-connector-aarch64-apple-darwin.sha256
8a3dd28ba2bee8fdbd3bbe51deaf7ca3d7fe79684f080bf93c1e4c2a6f7f0e7c ghostlight-mcp-connector-x86_64-apple-darwin
60081477475bd102ad4f41bacc75c8c24d3c703f2384ec724de12a085523adda ghostlight-mcp-connector-x86_64-apple-darwin.sha256
18a894d095a15ce4e6a6457a431baee37a8e7ad73ceaa0ef40f71a42677212af ghostlight-mcp-connector-x86_64-pc-windows-msvc.exe
8108ad122fd5ce3e8faa1e5a775fc7da2f50554f048f553bfd1c0d3fd20d9052 ghostlight-mcp-connector-x86_64-pc-windows-msvc.exe.sha256
4b122693b34456ed99de1a56c7a8609a6f12693d14e2208b2d462a670d832f1d ghostlight-mcp-connector-x86_64-unknown-linux-gnu
72589279a18810fc80245a2ab1d8ac3ae7c1b74bfe34cebb142d3d76570560a9 ghostlight-mcp-connector-x86_64-unknown-linux-gnu.sha256
ef19b7c69bc87845a892d8f05738c02b8cb54077c84407859078f1feb5ee41b2 ghostlight-v0.8.0-aarch64-apple-darwin.tar.gz
9e0ab3852ff10310cd707bea407a00083ce7e30908e139581ce01913bf8464d6 ghostlight-v0.8.0-aarch64-apple-darwin.tar.gz.sha256
45470483d16afd2acb7bc0a312695d6873400a82f1761089e2a738f7c68e9084 ghostlight-v0.8.0-sbom.cyclonedx.json
3864ffcdc60123f6fb6ac2dee3886354ca5324b824ceda769dbd678107fcc6a5 ghostlight-v0.8.0-x86_64-apple-darwin.tar.gz
6a1d1f8bcbdf564c716a86b556106e620c112e1a0444497a20d8fed918646bb0 ghostlight-v0.8.0-x86_64-apple-darwin.tar.gz.sha256
db0c0f5a95f75145eae496359e5bf7e0e388fd05a429c15956df557ed2be9fea ghostlight-v0.8.0-x86_64-pc-windows-msvc.zip
b74ea4ce51e747700fcde85a4a1c99bd32a3b494c2765a815815c51fc3f0dd93 ghostlight-v0.8.0-x86_64-pc-windows-msvc.zip.sha256
cfccecd708a7a015b0a78723eb25b4ef15731161eb410c24bd40490b08d889f3 ghostlight-v0.8.0-x86_64-unknown-linux-gnu.tar.gz
fe1bcc42864bf4b879d0ea0e8ea7c43031de3adadb9b231e639b7130c520eda6 ghostlight-v0.8.0-x86_64-unknown-linux-gnu.tar.gz.sha256
3994d769248e1ffacf1d0787a4d16568ff90d40c5988c31b06c97807b377e2b1 ghostlight-v0.8.0.mcpb
5a01da6ec61402de807cff2cc69996b57bc1a872e38a7218da3739523c17e730 ghostlight-v0.8.0.mcpb.sha256
755a894bcb0471dbaa41f79c5b8877292db56504d0dc3e00e7860316003e5574 ghostlight-x86_64-apple-darwin
89161997c97751e95f3bb745778084235b9616d952f9d4de3924aabd6df1294c ghostlight-x86_64-apple-darwin.sha256
2dd71e0a193155fcd76715aaa1d40cb55dc3c13b9fc20114c7b6c049f5284229 ghostlight-x86_64-pc-windows-msvc.exe
6a89dee777c4ef2e32da26b137c7ddc3b5512cd9d562b217c450b52ac59a5b17 ghostlight-x86_64-pc-windows-msvc.exe.sha256
6d11aa0d778de75199abfae5b49d71de3d3933eef18230530ea8a1e962238cce ghostlight-x86_64-unknown-linux-gnu
ed039e9335c026b3001d84ba90f1122900e0a4d8145a83c46aa6bde4e61bf18f ghostlight-x86_64-unknown-linux-gnu.sha256