Ghostlight

by sylin-org

Not rated
GitHub

About

Use your real signed-in Chromium browser from any MCP agent, with visible actions, local execution, and optional governance.

Details

Author
sylin-org
Categories
Developer Tools

Setup

Install Ghostlight in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/sylin-org/ghostlight

Follow the installation instructions in the repository README, then restart your MCP client.

Give your agent a place in the browser you already use.

A launch brief moves from empty form to ready for review, in full view.

Install Ghostlight|See where it fits|Installation guide|Trust Center

Ghostlight gives compatible AI agents a dedicated workspace inside the Chromium profile you already use. Your signed-in sessions are there. The work stays visible. You can pause, take over, or stop it at any time.

Ask an agent to read a page, complete a form, handle a file, follow a popup, or investigate a failed web workflow. Ghostlight carries the task across tabs and browser changes while keeping the browser work and its controls on your machine.

You need Chrome, Edge, Brave, or Chromium 116+, an MCP client, and Node.js for the installer. The service you run afterward is native Rust.
-

Install Ghostlight and register the MCP clients it finds:

AddGhostlight in Browserfrom the Chrome Web Store.

Restart an MCP client if it does not hot-reload tools.

Openhttps://example.com/in a new Ghostlight tab, summarize the page, and tell me which tab you used. Do not click, type, submit, or change the page.

A sky-blue Ghostlight group should appear in your browser. The agent opens the page, reads it, and names the exact tab it used. That one prompt proves the whole connection without authorizing a click or write.

doctorchecks the client entry, local service, browser connection, and extension, then names the next action. Theinstallation guidecovers targeted clients, Homebrew, source builds, updates, uninstall, and symptom-led recovery.

Ghostlight is at its best when browser work has a thread to follow:

- Pick up where you are signed in.Open an application in the Chromium profile you chose and work with the session already there. Credentials stay with the browser.
- Finish the interaction.Navigate, fill forms, upload files, resolve dialogs, wait for page state, and carry results from one step into the next.
- Follow the browser.Keep working when a site opens a supported child tab or when a known workspace changes underneath the task.
- See what failed.Bring page state, console messages, and network requests together so the next debugging step comes from evidence instead of guesswork.

Use the same browser capability from Codex, Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed, OpenCode, Crush, or another compatible stdio MCP client. Agents receive structured page reads, exact element references, bounded action receipts, and specific recovery guidance. They can callexplainfor the live action and capability directory whenever a task needs it.

Ghostlight works in a dedicated sky-blue tab group inside the browser window you chose. Page scans, clicks, typing, drags, and longer phases share one visual language, so the movement on screen has an explanation.

Pause the workspace, take over for a delicate step, or stop it. Move its tabs where you want them; Ghostlight follows the workspace instead of snapping it back. Ordinary tabs remain outside the agent's owned set.

Personal use is complete without a policy manifest. Start with the full browser engine and get useful work done. When a workflow needs stronger boundaries, grantread,action,write, andexecutecapabilities by MCP identity and domain. Add sacred domains, dry-run preflight, and structured audit while the browser experience stays the same.

Thegovernance guideshows the operating model. TheTrust Centercarries the security, privacy, continuity, deployment, and procurement evidence. Thedecision aidcovers other browser operating models when that is the question.

Platform state.Windows and Linux are verified end to end against live browsers. macOS builds and passes the full test suite in CI; its live-browser verification is still owed.

Extension state.The Chrome Web Store serves Chrome adapter v0.8.0. Chrome adapter v0.8.0 covers Ghostlight service versions v0.8.x. Install the extension from the public listing. See the fulladapter compatibility map.

The service and Chrome adapter version independently. Thecompatibility mapis authoritative, and thepublic status fileowns current release, platform, and store state.

The 0.8 source candidate implements exact local stdio MCP revisions2025-11-25and2026-07-28. See thechangelogfor release changes and upgrade consequences.

MCP Client <--stdio--> ghostlight-mcp-connector <--typed local IPC--> ghostlight service <--browser IPC--> ghostlight-browser-connector <--native messaging--> Extension <--CDP--> Browser

The connector owns MCP protocol state. The persistent service owns workspaces, browser coordination, optional governance, and audit. The browser connector passes native messages, while the extension owns Chrome mechanism. Each role can reconnect independently.

ADR-0096explains the boundary.docs/SPEC.mdgives the deeper governance model. Theinstallation guideincludes the source-development path.

The browser automation engine outsidecrates/core/src/governance/is Apache-2.0 OR MIT. The governance module is source-available under the Ghostlight Commercial License and is free for individuals, teams of up to five, evaluation, development, all-open operation, and qualifying noncommercial use.LICENSING.mdmaps the exact boundary.

License state never changes runtime behavior. An installed copy does not call a Ghostlight service for telemetry, activation, or updates, and it keeps working without the vendor. TheContinuity PromiseandPRICING.mdcarry the durable terms.

UseGitHub Issuesfor reproducible defects andGitHub Discussionsfor questions and ideas. Usehello@sylin.orgfor security, licensing, or information that cannot be public.

CONTRIBUTING.mdexplains the project's boundaries, test expectations, and ways to participate.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Create crafted UI components inspired by the best 21st.dev design engineers.

Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server

An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .

MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent

ALAPI MCP Tools,Call hundreds of API interfaces via MCP

AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform

MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.

APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.

One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.