From d81e6173c0e739f695dafb7ea68a05b73cad279f Mon Sep 17 00:00:00 2001 From: "Tommy D. Rossi" Date: Tue, 25 Nov 2025 19:08:45 +0100 Subject: [PATCH] add architecture diagram to README --- README.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/README.md b/README.md index 5a7bc44..9937e0a 100644 --- a/README.md +++ b/README.md @@ -151,6 +151,33 @@ Jetski exposes 17+ browser tools (`capture_browser_screenshot`, `browser_click_e The irony is that by trying to make browser control "simpler" with dedicated tools, these integrations make it slower, less capable, and waste context window that could be used for actual work. +## Architecture + +``` ++---------------------+ +-------------------+ +-----------------+ +| BROWSER | | LOCALHOST | | MCP CLIENT | +| | | | | | +| +---------------+ | | WebSocket Server | | +-----------+ | +| | Extension |<---------> :19988 | | | AI Agent | | +| | (bg script) | | WS | | | | (Claude) | | +| +-------+-------+ | | /extension | | +-----------+ | +| | | | ^ | | | | +| | chrome | | | | | v | +| | .debug | | v | | +-----------+ | +| v | | /cdp/:id <--------------> | execute | | +| +---------------+ | | | WS | | tool | | +| | Tab 1 (green) | | | Routes: | | +-----------+ | +| +---------------+ | | - CDP commands | | | | +| +---------------+ | | - CDP events | | v | +| | Tab 2 (green) | | | - attach/detach | | +-----------+ | +| +---------------+ | | Target events | | | Playwright| | +| +---------------+ | +-------------------+ | | API | | +| | Tab 3 (gray) | | | +-----------+ | +| +---------------+ | Tab 3 not controlled +-----------------+ +| | (user didn't click icon) ++---------------------+ +``` + ## Security Playwriter is designed with security in mind, ensuring that only you can control your browser.