Skip to content

Linux managed Playwright tier: tracking (L0..L6, cutover) #119

Open

Description

@chaodu-agent

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

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

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.sh offers 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

  1. added
    enhancementNew feature or request
    p3Priority 3: RFC, roadmap, nice-to-have or deferred
    on Nov 14, 2026
  2. chaodu-agent commented on Nov 16, 2026

    @chaodu-agent
    ContributorAuthor

    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):

    OQ Topic Decision
    OQ1 Shared pin set One pins.json, schema 2, keyed by platform
    OQ2 Linux Chromium source Chrome for Testing where it has the pin, else Playwright CDN
    OQ3 Download/hash/extract tooling Small set of audited Rust crates in-process
    OQ4 Process containment Kernel-enforced tree (systemd transient service first)
    OQ5 Managed vs MCP_UPSTREAM browser= Managed wins unless MCP_BROWSER_BACKEND=external
    OQ6 Non-interactive browser download Skip unless --browser managed or --yes
    OQ7 Root actions in installer No sudo by default; explicit --apply-system-changes
    OQ8 Headless-seat sign-in Existing screenshot/mouse/key tools plus documented loopback recipe
    OQ9 Old profile and cookies Start fresh, leave old profile untouched
    OQ10 Legacy cleanup Manual documented list, installer never deletes
    OQ11 Cookie password store --password-store=basic
    OQ12 Tarball authenticity GitHub build-provenance attestations
    OQ13 Host cutover One host first, one-week soak, then the rest
    OQ14 Old browser path lifetime Keep pw-mcp.sh one more minor release, deprecated
    OQ15 Unknown upstream tools Filter managed to catalog; external passes through
    OQ16 Supported distros Debian 12+, Raspberry Pi OS, Ubuntu 22.04+ on amd64/arm64; musl refused
    OQ17 Offline nodes Keep the refusal gate, add browser install --from-dir

    Refs #118.

  3. chaodu-agent commented on Nov 16, 2026

    @chaodu-agent
    ContributorAuthor

    Non-blocking follow-ups from the ADR review are tracked in #132. The first implementation PR is L0 (shared pins schema 2 and validators).

  4. changed the title [-]Linux installer: Playwright-based browser_* tier (design later)[/-] [+]Linux managed Playwright tier: tracking (L0..L6, cutover)[/+] on Nov 16, 2026
  5. added
    p2Priority 2: real bug or scoped planned work
    and removed
    p3Priority 3: RFC, roadmap, nice-to-have or deferred
    on Nov 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestp2Priority 2: real bug or scoped planned work

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions