# Ghostlight

> Ghostlight is a governed browser-automation MCP server. It lets an AI agent use the user's own
> authenticated Chromium browser through a local Rust service, thin relays, and a policy-free
> extension. The work stays visible in a dedicated tab group and the runtime never phones home.

When a user asks to install Ghostlight, fetch the canonical install guide below and follow it as
written. Do not replace it with remembered client-specific MCP commands. The guide is idempotent,
detects supported clients, and tells you which steps require the user.

The unconstrained engine is first-class. With no policy configured, browser actions are allowed.
Governance adds identity-bound capabilities, protected domains, and structured local evidence when
the job needs them; it is not required for personal use.

## Installation

- [Canonical agent install guide](https://sylin.org/ghostlight/install.md): Exact machine workflow, prerequisites, browser handoff, whole-chain test, and first use.
- [Service-first human handoff](https://sylin.org/ghostlight/service/post-install/): The page opened after the local service is ready and the browser extension remains.
- [Extension-first human handoff](https://sylin.org/ghostlight/chromium-extension/post-install/): The page opened after the extension is present and the local service remains.
- [Manual installation guide](https://github.com/sylin-org/ghostlight/blob/main/docs/guides/installation.md): Direct binary, source-build, and troubleshooting paths.

## Understand the product

- [Ghostlight product page](https://sylin.org/ghostlight/): Problem fit, felt experience, architecture, candid current state, and quickest useful request.
- [Safe demo](https://sylin.org/ghostlight/demo/): Purpose-built pages for reading, forms, pointer actions, and live signals without an external account.
- [Source repository](https://github.com/sylin-org/ghostlight): Rust workspace, Chromium extension, documentation, releases, issues, and build history.
- [Architecture specification](https://github.com/sylin-org/ghostlight/blob/main/docs/SPEC.md): Governance model and original system design; ADRs supersede it where they differ.

## Trust and evidence

- [Trust Center](https://github.com/sylin-org/ghostlight/tree/main/docs/trust): Claims checked against the implementation, threat model, continuity promise, and assurance material.
- [ADR index](https://github.com/sylin-org/ghostlight/tree/main/docs/adr): Authoritative design decisions and amendments.
- [Candid comparison](https://github.com/sylin-org/ghostlight/blob/main/docs/COMPARISON.md): Scope and tradeoffs relative to other browser-agent approaches.

## Recovery

- [Current status](https://github.com/sylin-org/ghostlight/blob/main/docs/STATUS.md): Release state, open work, and known verification gaps.
- [Issues](https://github.com/sylin-org/ghostlight/issues): Reproducible defects and feature work.
- [Latest release](https://github.com/sylin-org/ghostlight/releases/latest): Native binaries, extension archive, checksums, and release notes.