Repository navigation
Description
Tracking issue for the Linux managed Playwright tier. Design: docs/adr/linux-browser-tier.md and docs/requirements/linux-browser-tier.md (section "4. PR split"). Parent tracker: #118.
PRs
- Design (ADR and requirements): docs: Linux managed Playwright tier ADR and requirements (#119) #131
- L0 Shared pins: feat: pins.json schema 2 with Linux platforms (L0, #119) #133
- L1a Download and extract: feat: Linux browser tier L1a: manifest, bounded download and safe extraction (#119) #136
- L1b State and install: feat: Linux browser tier L1b: state, ownership and install/update/remove (#119) #142
- L2 Managed child and router: feat: Linux browser tier L2: managed child, containment and router (#119) #143
- L3 Installer and docs: feat: Linux browser tier L3: installer, browser signin and docs (#119, #130) #144
- L4 Hardening: feat: Linux browser tier L4: hardening tiers, probes and flaky-test fix (#119, #147) #156
- L5 Release and cutover
- L6 PID-namespace mechanism
- Cutover (D13, OQ13): one host first, one-week soak, then the rest
- Remove the legacy pw-mcp path one minor release later (D14, OQ14): Remove the legacy pw-mcp 8794 path one minor release after the Linux managed tier ships #141
Before L5: confirm ADR D7 (AppArmor, single glob profile, marked as built and to be confirmed by the owner in docs/adr/linux-browser-tier.md).
Release blocker for L5: The managed tree holds two listening Unix sockets (the Playwright browser socket and Chromium SingletonSocket, inside a private 0700 TMPDIR; 0 TCP, 0 UDP), which contradicts R1.1 (no listener); resolve or formally accept before L5 (V2).
Related
- Linux managed Playwright tier: follow-ups from the ADR review (#119) #132: follow-ups from the ADR review and L1a (to fold into L1b)
- install-linux.sh requires wlrctl, which Ubuntu 24.04 does not package for aarch64 (and nothing uses it?) #130:
install-linux.shrequireswlrctl(affects L3, Installer and docs) - Linux: wss:// mint in the attach client #140:
wss://mint in the attach client
Original body (before the tracking rewrite)
Context
Issue #118 decided the browser_* tiers. On macOS, Playwright is now the preferred tier and the wizard step that installs it is pre-checked (the user can opt out). Apple Events is macOS-only, so on Linux browser_* can only come from Playwright, alongside the existing Wayland screen/input tools (grim, wlroots virtual pointer, wtype).
This issue tracks the Linux installer side. The design is to be done later, not now. Everything below is an open question, not a decision.
Scope (all open)
- How
install-linux.shoffers and downloads Playwright: Node,@playwright/mcp, Chromium. Both amd64 and arm64. - Persistent browser profile and the one-time human login. Login needs a display: a seat on a wlroots compositor, or a virtual display with remote viewing on headless nodes.
- Chromium system library dependencies, and whether installing them needs root.
- Verification and pinning of downloads, under the same supply-chain rules as the macOS design (internal design draft; reference removed).
- Listener bound to loopback only (
127.0.0.1:8794) behind--upstream. - systemd unit naming consistent with
oab-computer-pw-mcp.service. - Some sites (for example Google sign-in) block automated browsers, so logged-in flows may not work everywhere.
Related: #118
Activity
chaodu-agent commentedon Nov 16, 2026
Design PR for the Linux managed Playwright tier: #131
It adds the ADR and requirements. It is docs only and is not merged. The 17 open questions are decided (option 1 for each):
pins.json, schema 2, keyed by platformMCP_UPSTREAM browser=MCP_BROWSER_BACKEND=external--browser managedor--yes--apply-system-changes--password-store=basicpw-mcp.shone more minor release, deprecatedbrowser install --from-dirRefs #118.
docs: Linux managed Playwright tier ADR and requirements (#119) (#131)
chaodu-agent commentedon Nov 16, 2026
Non-blocking follow-ups from the ADR review are tracked in #132. The first implementation PR is L0 (shared pins schema 2 and validators).
feat: pins.json schema 2 with Linux platforms (L0, #119) (#133)
feat: Linux browser tier L1a: manifest, bounded download and safe ext…
[-]Linux installer: Playwright-based browser_* tier (design later)[/-][+]Linux managed Playwright tier: tracking (L0..L6, cutover)[/+]fix: L1b review HIGH findings: temp-file ownership, bounded line queu…
fix: L1b compare-and-swap for record replace, no overwrite of pending…
fix: L1b fail-closed record replace and delete (#119)
feat: Linux browser tier L1b: state, ownership and install/update/rem…
fix: L2 review round 1: router, self-test listing, run-record cap, am…
feat: Linux browser tier L2: managed child, containment and router (#119
feat: Linux browser tier L3: installer, browser signin and docs (#119, …
fix: gate the mount tier on a verified mount effect, skip unit tests …
fix: gate the mount tier on a verified mount effect, skip unit tests …
feat: Linux browser tier L4: hardening tiers, probes and flaky-test f…
fix: review round for L5: token quoting, blocking-gate record check, …
feat: Linux browser tier L5: release gates, provenance, legacy listin…