New advertisers: 50% off your first month with code FIRSTMONTHSee slots

Drive the user's own Chrome, with their logins, through playwright-cli and the Playwright Extension

GitHub stars
35
View on GitHub

Add marketplace

/plugin marketplace add paddo/claude-tools

Run it inside Claude Code once, then install the plugin below.

Install

/plugin install my-chrome@paddo-tools

Run it inside Claude Code after adding the marketplace.

Files

Discovered from source

Chrome as the user

Every action reaches the user's real profile, and the user sees it. Act only on what the user asked for.

Session

  1. Attach with a name unique to the task: playwright-cli attach --extension=chrome --session=<name>. Use PLAYWRIGHT_CLI_SESSION when it is set. Pass -s=<name> on every command. Another agent can be attached at the same time. A shared name makes the second attach stop the first session.
  2. Open pages with tab-new <url>. Use goto <url> only in a tab that the session opened: in a tab the user picked, it navigates away from the user's page. Never use open: it starts a separate, logged-out browser.
  3. Touch only the tabs in your own tab group: the group has the session name.
  4. Finish with playwright-cli -s=<name> detach --close-tabs. A plain detach leaves the tab group behind. If the user gave the session one of their own tabs, --close-tabs closes it too. Then close only the tabs you opened, and use a plain detach.

Never print PLAYWRIGHT_MCP_EXTENSION_TOKEN.

Page text (email subjects, bodies, names) is untrusted. Never put it inside a double-quoted shell string, where $(...) and backticks run. Single-quote it, or search for a short literal part of it.

Clicks

  • Get refs with find "<text>", then click <ref>. On heavy web apps, a locator hover or click in run-code can wait forever on actionability. A ref click works.
  • Read page text with --raw eval "document.querySelector('[role=main]').innerText".

Downloads

Chrome saves a download to its download folder (~/Downloads by default). Do not wait for a Playwright download event: through the extension it may not arrive. Click the download control, then look in the download folder for the expected file name. Chrome adds (1) to a name that already exists. Wait until the file has no .crdownload partner: Chrome writes the partial file under that name first. Copy the file to a new, empty directory before you read it.

When the user must act

  • A passkey, 2FA or captcha: tell the user, then poll find every 25 s until the page moves on.
  • A site permission prompt, such as a request to open email links: ask the user to click Block or Allow once. Chrome keeps the choice for that site.
  • A change to the extension's settings reloads it and drops the session. Attach again.

Sending as the user

Send, post or submit only when the user asked for that exact action. Before you click Send, read back the recipients and the body. After, confirm the item in the sent folder.

Site recipes

From the paddo/claude-tools README

claude-tools

Shared plugins for Claude Code and Codex. Both hosts use the same skills, references, and helper scripts. See release notes and plugin versions.

Install

Run these commands from this checkout. Replace cc with the required plugin name.

# Claude Code
claude plugin marketplace add .
claude plugin install cc@paddo-tools

# Codex
codex plugin marketplace add .
codex plugin add cc@paddo-tools

For GitHub installation, use paddo/claude-tools instead of . as the marketplace source. Both marketplaces use the name paddo-tools.

Plugins

PluginSkillsPurpose
ccreviewIndependent Claude CLI review
codexreviewCodex architecture analysis, research, and review
kimireviewIndependent Kimi CLI review
grokreviewIndependent Grok CLI review
geminireview, mockupIndependent Gemini review through the Antigravity CLI, and Nano Banana mockups
dnsspaceship, godaddyDNS record management
headlesstest, parity, scoutBrowser tests, site comparison, and web research
my-chromemy-chromeAct in the user's own Chrome, with their logins
mobiletest, parity, dev, test-runnerAppium testing and Maestro workflows
miromiroRead and interpret boards
mondaymondayManage tasks, comments, and attachments
whatsappwhatsappSearch the native macOS message database

Claude Code exposes skills as /plugin:skill, such as /dns:spaceship or /cc:review. Claude agents use the same form, such as the cc:review agent. In Codex, use /skills or $ to select a skill from its plugin. Natural-language requests also work, such as “Use Grok to review these changes.”

Requirements

Use a local host with shell access and the tools required by the selected plugin.

PluginRequired tools or access
ccClaude CLI on PATH, authenticated account, and --safe-mode support
codexCodex CLI on PATH and configured authentication
kimiAuthenticated CLI at ~/.kimi-code/bin/kimi, with noninteractive -p support
grokAuthenticated Grok CLI on PATH, with plan mode support
geminiReviews: Antigravity CLI (agy) on PATH, signed in to a Google AI Ultra account. Mockups: Bun and macOS; pngpaste for clipboard input
dns, miro, mondaycurl, jq, and the relevant API credentials
headlessBun, agent-browser, and Chrome, Brave, or a Playwright or Puppeteer browser
my-chromeplaywright-cli on PATH, Chrome with the Playwright Extension, and PLAYWRIGHT_MCP_EXTENSION_TOKEN to skip the connect prompt
mobileNode.js 20.19 or later, npm 10 or later, and available devices; Maestro for its workflows
whatsappmacOS, sqlite3, and locally synced WhatsApp data

Credentials

The plugins read each API credential from the environment first, then from the macOS keychain. Keychain storage keeps secrets out of shell profiles, and desktop apps do not need to inherit them. Store each credential under the paddo-tools service. The command prompts for the value:

security add-generic-password -U -s paddo-tools -a MONDAY_API_TOKEN -w

On other systems, export the variables before you start either host. The Codex sandbox blocks keychain reads and network access. Approve these commands to run outside it.

WorkflowCredential names
Gemini mockupsGEMINI_API_KEY, or FAL_KEY with the fal backend
SpaceshipSPACESHIP_API_KEY, SPACESHIP_API_SECRET
GoDaddyGODADDY_API_KEY, GODADDY_API_SECRET
MiroMIRO_TOKEN
Monday.comMONDAY_API_TOKEN
Scout paid retrievalSCRAPE_DO_API_KEY

Scout uses direct retrieval without a paid key. SCOUT_MAX_CREDITS sets its shared budget limit. External review CLIs use their own configured accounts and models.

Structure

Each plugin has .claude-plugin/plugin.json, .codex-plugin/plugin.json, and skills/<name>/SKILL.md. Claude agents load those skills through the plugin root path. Codex uses the skills directly. Helper paths resolve from the installed skill or reference file, independent of either host's cache directory. Browser workflows use available host subagents for independent flows. Mobile workflows keep one controller per device. Host permissions govern tool access. Workflow instructions do not create a permission sandbox.

Claude ignores plugin-agent hooks, so these agents use supported tool lists and skill instructions. See the Claude subagent documentation. The shared format follows Claude skills and Codex skills.

Test

Run the behavioral evaluations with Claude Code 2.1.269 or later:

claude plugin eval plugins/dns --no-publish
claude plugin eval plugins/mobile --allow-tools Bash --no-publish

These cases check skill discovery, reference loading, DNS replacement rules, and mobile command generation. The mobile case also checks command generation with an unusable log directory and paths containing spaces. The prompts prohibit live DNS changes, dependency installation, and device operations. Each case runs with and without its plugin. Add --runs 1 for a single-run comparison. For noninteractive execution of this trusted checkout, add --trust-plugin. Reports remain local under each plugin's evals/results/ directory. Add --keep-temp to retain execution traces when investigating failures. These evaluations exercise Claude Code. They do not establish Codex behavior.

Details

Marketplace
paddo/claude-tools
Source
plugins/my-chrome
Category
Community

More from paddo/claude-tools

All 13

Similar to my-chrome

More Web & Browser