Skip to content

v0.8.0

Choose a tag to compare

@github-actions github-actions released this 07 Aug 06:00
· 382 commits to main since this release
993135b

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 remains ghostlight, and
    Chromium launches ghostlight-browser-connector. The old dual-role ghostlight-relay path 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

  1. Install the service and register detected MCP clients: npx -y ghostlight install.
  2. Install Ghostlight in Browser
    from the Chrome Web Store.
  3. 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