Skip to content

Add Claude Code project configuration with chrome-host MCP bridge for browser automation#717

Merged
bedrich-schindler merged 1 commit into
masterfrom
task/claude-integration
Jul 4, 2026
Merged

Add Claude Code project configuration with chrome-host MCP bridge for browser automation#717
bedrich-schindler merged 1 commit into
masterfrom
task/claude-integration

Conversation

@bedrich-schindler

Copy link
Copy Markdown
Contributor

Introduce CLAUDE.md and a .claude/ directory so Claude Code works from the project's documented conventions instead of guessing.

  • CLAUDE.md — entry doc: project overview, the devcontainer command workflow, and an index of rules, agents and the /commit skill.
  • .claude/rules/ — always-on rules (code, git, safety-guards) and path-scoped rules (frontend, styling, testing, docs) carrying the project conventions.
  • .claude/skills/commit/ — the /commit skill for committing per project rules.
  • .claude/agents/code-reviewer.md — a repo-tailored review agent.
  • .claude/settings.json — scoped command permissions and enables the chrome-host MCP server (plus the GitHub and Context7 plugins).

Speaking of chrome-host MCP bridge:

Add tooling that lets an MCP-capable assistant in the devcontainer drive Chrome running on the host via chrome-devtools-mcp over the Chrome DevTools Protocol.

Because the container can only reach the host through host.docker.internal and Chrome's DevTools endpoint rejects non-IP Host headers, a small loopback proxy (cdp_proxy.py) runs inside the node container and forwards to host Chrome, so the Host Chrome sees stays 127.0.0.1.

Includes the host launcher (start-host-chrome.sh, throwaway profile opening the docs site), the in-container launcher and entry scripts, native-Docker host-gateway setup, MCP registration for Claude/Copilot (.mcp.json) and OpenCode (opencode.json), and documentation.

@github-actions

github-actions Bot commented Jun 30, 2026

Copy link
Copy Markdown
Contributor
PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-07-04 12:30 UTC

@github-project-automation github-project-automation Bot moved this to 💡Ideas in The Board Jul 1, 2026
@adamkudrna adamkudrna moved this from 💡Ideas to 👀 In review in The Board Jul 1, 2026

@adamkudrna adamkudrna left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So we are dumping ourselves into markdowns, aren't we 🙂.

Although I went through the chrome-host stuff and "understand" it, my official statement is "I have no idea what's going on".

I'm really looking forward to get this working.

Comment thread setup.sh
Comment thread CLAUDE.md
Comment thread CLAUDE.md Outdated
Comment thread CLAUDE.md Outdated
Comment thread scripts/mcps/chrome-host/README.md
Comment thread .claude/skills/commit/SKILL.md
Comment thread .claude/rules/code.md
Comment thread .claude/agents/code-reviewer.md

@mbohal mbohal left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I did not read it throughly, but I confirm it runs on Linux.

… browser automation

Introduce CLAUDE.md and a .claude/ directory so Claude Code works from the
project's documented conventions instead of guessing.

* CLAUDE.md — entry doc: project overview, the devcontainer command workflow,
  and an index of rules, agents and the `/commit` skill.
* .claude/rules/ — always-on rules (code, git, safety-guards) and path-scoped
  rules (frontend, styling, testing, docs) carrying the project conventions.
* .claude/skills/commit/ — the `/commit` skill for committing per project rules.
* .claude/agents/code-reviewer.md — a repo-tailored review agent.
* .claude/settings.json — scoped command permissions and enables the
  `chrome-host` MCP server (plus the GitHub and Context7 plugins).

Speaking of chrome-host MCP bridge:

Add tooling that lets an MCP-capable assistant in the `devcontainer` drive
Chrome running on the host via `chrome-devtools-mcp` over the Chrome DevTools
Protocol.

Because the container can only reach the host through `host.docker.internal`
and Chrome's DevTools endpoint rejects non-IP `Host` headers, a small loopback
proxy (`cdp_proxy.py`) runs inside the `node` container and forwards to host
Chrome, so the `Host` Chrome sees stays `127.0.0.1`.

Includes the host launcher (`start-host-chrome.sh`, throwaway profile opening
the docs site), the in-container launcher and entry scripts, native-Docker
host-gateway setup, MCP registration for Claude/Copilot (`.mcp.json`) and
OpenCode (`opencode.json`), and documentation.
@bedrich-schindler
bedrich-schindler force-pushed the task/claude-integration branch from a4221b6 to bb0da69 Compare July 4, 2026 12:28
@bedrich-schindler
bedrich-schindler merged commit 2ea3e1f into master Jul 4, 2026
13 checks passed
@bedrich-schindler
bedrich-schindler deleted the task/claude-integration branch July 4, 2026 12:30
@github-project-automation github-project-automation Bot moved this from 👀 In review to ✅ Done in The Board Jul 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

Status: ✅ Done

Development

Successfully merging this pull request may close these issues.

3 participants