# Chrome MCP Control Center

**Single-click Windows Chrome Computer-Use MCP** for non-technical users.

Install one app → open one desktop shortcut → complete a short wizard → click **Start All** → pair your LLM → automate Chrome safely.

## Features (MVP)

- **Control Center** desktop app (Start All / Stop All / Emergency Stop)
- **Local MCP server** (stdio + optional loopback HTTP)
- **Chrome extension** (Manifest V3) + **Native Messaging**
- **DOM-first** browser tools; **computer-use** fallback (guarded)
- **Permission engine** (read-only → reversible → commitment; L3 blocked)
- **LLM pairing** for Grok CLI, Claude, Codex, generic MCP clients
- **Health check**, **Repair**, audit logs with redaction

## Quick start (developers)

```powershell
npm install
npm run build
npm test
npm run desktop
```

End-user install: see [INSTALLATION.md](INSTALLATION.md).  
Pairing: [LLM_PAIRING.md](LLM_PAIRING.md).  
Architecture: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).  
Living status: [CONTEXT.md](CONTEXT.md).

## Vertical slice

1. Open Control Center → Start All  
2. Extension connects via Native Messaging  
3. Pair Grok CLI  
4. `browser_list_tabs` → `browser_read_page` → approve → `browser_click`  
5. Emergency Stop blocks next action  
6. Stop All clean shutdown  

## Security

See [SECURITY.md](SECURITY.md) and [THREAT_MODEL.md](THREAT_MODEL.md).  
Webpage content is untrusted. Passwords and payment data never return to the LLM.

## Versioning

SemVer **MAJOR.MINOR.PATCH**. One number everywhere (app, extension, installers, GitHub tag).

```powershell
npm run version:patch    # or version:minor / version:major
npm run version:sync     # sync desktop, extension, VERSION, src/version.ts
```

Installers (from next pack):

- `ChromeMCP-ControlCenter_1.0.4_win-x64_Setup.exe`
- `ChromeMCP-ControlCenter_1.0.4_win-x64_Portable.exe`

Details: [docs/VERSIONING.md](docs/VERSIONING.md).

## Cloud improvement sync

Free and Paid both sync **operational** telemetry to the owner backend (after consent). Free is not local-only for diagnostics. Secrets are never uploaded.

```powershell
npm run cloud:backend          # owner ingest + dashboard :8788
# Control Center → Cloud & Privacy → Accept agreement → Sync now
```

See [docs/CLOUD_SYNC.md](docs/CLOUD_SYNC.md).

## Obsidian knowledge base

Docs sync into the TTRG vault under `10-Projects/chrome-mcp-control-center/` (wikilinks, redacted).

```powershell
npm run obsidian:export
```

Runs automatically after `npm run build` and `npm run desktop:pack`. Secrets and private logs are excluded.

## License

MIT