v1.0.0 — initial production release

Changelog

All notable changes to Relay for AI Agents are documented here. The
format is loosely based on Keep a Changelog; the project uses semantic
versioning starting at 1.0.0.

[1.0.0] — 2026-05-07

First production release. Renamed from claude-browser-mcp to
relay-for-ai-agents to reflect that the project is host-agnostic and works
with any MCP-compatible AI agent (Claude Desktop, Cursor, Cline,
Continue.dev, opencode, OpenAI Codex CLI, custom agents).

Breaking changes from 0.4.x

• npm package renamed: claude-browser-mcp → relay-for-ai-agents
• MCP entry name renamed: claude-browser-mcp → relay-for-ai-agents
• Environment variables renamed:
  • CLAUDE_BROWSER_MCP_PORT → RELAY_PORT
  • CLAUDE_BROWSER_MCP_HOST → RELAY_HOST
  • CLAUDE_BROWSER_MCP_TOKEN → RELAY_TOKEN
  • CLAUDE_BROWSER_MCP_LABEL → RELAY_LABEL
  • CLAUDE_BROWSER_MCP_SESSION → RELAY_SESSION
• Extension display name changed.

Migration: re-run node install.mjs (or node bin/setup.js). The installer
auto-detects and removes any legacy claude-browser-mcp entry from the
existing config.

Added

• README.md, LICENSE (MIT), CHANGELOG.md, docs/privacy-policy.md.
• Multi-host setup documentation: Cursor, Cline, Continue.dev, opencode,
  Codex CLI, custom agents.
• New "R" monogram icon (replaces previous "C" placeholder).
• Updated PDF guide reflects the rebrand and new positioning.

Unchanged

• Wire protocol stays compatible with V0.4.x extensions until the next
  breaking version bump (V1.x → V2.0).
• All 15 MCP tools are unchanged in shape and behavior.
• Self-electing broker model and session binding from V0.4.

---

Pre-1.0 history (under previous claude-browser-mcp name)

[0.4.2] — 2026-05-07

• One-shot installer (install.mjs) auto-detecting Microsoft Store Claude
  Desktop on Windows, choosing the cmd-wrapper or env-block format
  appropriately, generating tokens, writing UTF-8 without BOM.
• Multi-browser config documented (one Claude session controlling N
  browsers via N MCP entries on N ports).
• Firewall setup recipes for Windows, macOS, Linux.
• Stronger Tailscale guidance.

[0.4.1] — 2026-05-06

• Microsoft Store Claude Desktop sandbox detection and cmd /c "set X=Y&& …" wrapper format to bypass the env-block-dropping quirk.
• Expanded troubleshooting in PDF: symptom-driven recipes covering bind
  failures, firewall drops, BOM corruption, and dual-broker situations.
• New FAQ section answering multi-browser, multi-session, and security
  model questions.

[0.4.0] — 2026-05-05

• Configurable scope: extension popup gains WebSocket URL + token fields;
  values persist in chrome.storage.local.
• Token-based bearer authentication with RELAY_TOKEN (then named
  CLAUDE_BROWSER_MCP_TOKEN). Setup CLI refuses non-loopback host without
  a token.
• Configurable listen interface via RELAY_HOST (then
  CLAUDE_BROWSER_MCP_HOST).
• Session binding: extension can lock to a specific MCP session id; broker
  rejects tool calls from any other session.
• Manual Connect / Disconnect button in popup with sticky storage flag.
• 4401 close code on auth failure; extension stops auto-reconnect loop.
• Smoke test (scripts/smoke-v4.mjs) covering token auth + binding
  enforcement.

[0.3.0] — 2026-05-05

• Self-electing broker / relay architecture: first MCP server process to
  bind the port becomes broker; subsequent ones connect to it as relay
  clients and forward tool calls. Multi-session support.
• Broker takeover: when the broker process exits, relays race (with
  jitter) to take over the port — no service interruption.
• Extension popup gains a sessions list with broker / relay badges, pid,
  connect time, and session id.
• Connection-state UI: green / red / amber dots and inline error display.

[0.2.x] — 2026-05-04

• 7 power tools added: get_page_text, find (CSS or text), read_network_requests,
  javascript_tool, form_input, file_upload, resize_window.
• 4 parity tools added on top of V1: hover action, click-by-ref,
  select_option, read_console_messages.
• Extension keepalive — service worker idle timer reset by server-driven
  10s pings (Edge enforces ≥1 minute on chrome.alarms, too long).
• Concurrent-connect guard prevents the duplicate-WebSocket storm.

[0.1.0] — 2026-05-04

• Initial scaffold. 6 core MCP tools: tabs_context_mcp,
  tabs_create_mcp, tabs_close_mcp, navigate, computer (screenshot,
  click, type, key, scroll, wait), read_page.
• MCP server speaks stdio; bridges to a Chromium MV3 extension via local
  WebSocket.
• "Claude MCP" tab group keeps agent-controlled tabs separate from the
  user's own tabs.
• Tarball-based fallback installer for environments where npm install
  hangs (npm 11 / Windows ETIMEDOUT bug).