# ghostlight

Runs local browser automation inside your active Chromium tabs via MCP. Your agent works in full view using your existing logged-in sessions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: sylin-org
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sylin-org/ghostlight
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/ghostlight

## What it does

Ghostlight links coding assistants to your running Chrome, Brave, or Edge instance. Instead of spinning up an isolated blank window without cookies, it groups agent tabs right inside your existing profile. Every click, keystroke, and page transition remains visible.

A native Rust daemon talks to your browser over local IPC alongside a dedicated browser extension. The server registers 23 catalog tools covering tab control, semantic clicks, form submission, screenshots, and file uploads.

macOS is not supported yet, limiting agent setup strictly to Windows and Linux. You also need Chromium 125 or newer and Node.js if you run the `npx` installer.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add ghostlight -- npx -y ghostlight
```

### Codex

**Platform CLI**
```bash
codex mcp add ghostlight -- npx -y ghostlight
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ghostlight": {
            "command": "npx",
            "args": [
                "-y",
                "ghostlight"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ghostlight": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "ghostlight"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add ghostlight npx -y ghostlight
```

## When to use it
- automate tasks inside pages that already require active user login
- monitor web navigation steps directly in a visible browser tab group
- submit complex web forms and handle file uploads through agent tools
- capture page screenshots and inspect DOM content locally

## Example prompts
- Open https://example.com/ in a new Ghostlight tab, summarize the content, and do not submit any forms.
- Navigate to sylin.org/ghostlight/demo/desk and ring the bell.

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32260
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13181
- [apify-mcp-server](https://affpapa.org/en/nevibecode/mcp/apify-mcp-server.md) — MCP server · ★ 13345

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md