W — Windows support (stretch): port surface and prerequisites #56

Open
1 of 1 issue completed
Open
W — Windows support (stretch): port surface and prerequisites#56
1 of 1 issue completed
Labels
area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command
Milestone
Phase W — Windows (stretch)

Description

@yashranaway
yashranaway
opened on Aug 5, 2026

Tracking issue for the Windows port. Not required for "done" — owner decision, 2026-08-04: later / best-effort. See architecture decisions §6 and ROADMAP Phase W.

Blocked on

Phase 2 — the HostCore + BrowserEngine extraction (#21) and typed errors (#22). Without that seam, Windows means a third hand-written copy of every command. Do not start before it lands.

Shape of the work

The WKWebView host is never ported. Windows runs the Chromium engine only.

  • Transport — named pipes with a SID-based peer check, replacing AF_UNIX + getpeereid/SO_PEERCRED. Windows has AF_UNIX, but no filesystem mode bits and no SO_PEERCRED, and the stale-socket probe does not map.
  • Runtime directory — %LOCALAPPDATA% with ACLs instead of /tmp/headless-<uid> at 0700.
  • Process spawn — CreateProcess + CreatePipe + SetHandleInformation. Chromium on Windows takes --remote-debugging-pipe handles via STARTUPINFO, not fds 3/4, so spawnChromium needs a Win32 rewrite.
  • CDP I/O — overlapped I/O or WaitForMultipleObjects instead of poll().
  • Artifact store — ACLs instead of POSIX modes; CREATE_NEW for the O_EXCL guarantee. Every "0600 in a 0700 dir" claim is POSIX-only today.
  • Signals — console control handler instead of SIGTERM/SIGINT dispatch sources.
  • Browser discovery — registry + Program Files, Edge as a candidate, ; PATH splitting.
  • FFmpeg discovery — .exe resolution under the same allow-list-not-PATH rule.
  • Elevation check — replace the getuid() != 0 root refusal with an elevated-token check.
  • Scripts — the build/test/E2E suite is POSIX sh; needs re-authoring.
  • Distribution — winget manifest (Phase 3 patterns apply).

Already portable

Protocol.swift, CLI.swift, AgentRuntime.swift (the injected JS is engine-agnostic), Diagnostics.swift, Flows.swift, CaptureFormats.swift, ScreenshotSeries.swift, MCP/main.swift, and Recording.swift modulo executable discovery.

Interim answer

Docker Desktop / WSL2 with the published image (#41). That is the documented Windows path until this ships.

Exit test

The Linux E2E scenario passes on a Windows runner against the Chromium engine, and winget install headless works.

Activity

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

    area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command

    Type

    No type

    Projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

    , 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
     blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

    Skip to content
    W — Windows support (stretch): port surface and prerequisites #56
    Open
    1 of 1 issue completed
    Open
    W — Windows support (stretch): port surface and prerequisites#56
    1 of 1 issue completed
    Labels
    area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command
    Milestone
    Phase W — Windows (stretch)
    Description
    @yashranaway
    yashranaway
    opened on Aug 5, 2026
    Tracking issue for the Windows port. Not required for "done" — owner decision, 2026-08-04: later / best-effort. See architecture decisions §6 and ROADMAP Phase W.
    Blocked on
    Phase 2 — the HostCore + BrowserEngine extraction (#21) and typed errors (#22). Without that seam, Windows means a third hand-written copy of every command. Do not start before it lands.
    Shape of the work
    The WKWebView host is never ported. Windows runs the Chromium engine only.
    • Transport — named pipes with a SID-based peer check, replacing AF_UNIX + getpeereid/SO_PEERCRED. Windows has AF_UNIX, but no filesystem mode bits and no SO_PEERCRED, and the stale-socket probe does not map.
    • Runtime directory — %LOCALAPPDATA% with ACLs instead of /tmp/headless-<uid> at 0700.
    • Process spawn — CreateProcess + CreatePipe + SetHandleInformation. Chromium on Windows takes --remote-debugging-pipe handles via STARTUPINFO, not fds 3/4, so spawnChromium needs a Win32 rewrite.
    • CDP I/O — overlapped I/O or WaitForMultipleObjects instead of poll().
    • Artifact store — ACLs instead of POSIX modes; CREATE_NEW for the O_EXCL guarantee. Every "0600 in a 0700 dir" claim is POSIX-only today.
    • Signals — console control handler instead of SIGTERM/SIGINT dispatch sources.
    • Browser discovery — registry + Program Files, Edge as a candidate, ; PATH splitting.
    • FFmpeg discovery — .exe resolution under the same allow-list-not-PATH rule.
    • Elevation check — replace the getuid() != 0 root refusal with an elevated-token check.
    • Scripts — the build/test/E2E suite is POSIX sh; needs re-authoring.
    • Distribution — winget manifest (Phase 3 patterns apply).
    Already portable
    Protocol.swift, CLI.swift, AgentRuntime.swift (the injected JS is engine-agnostic), Diagnostics.swift, Flows.swift, CaptureFormats.swift, ScreenshotSeries.swift, MCP/main.swift, and Recording.swift modulo executable discovery.
    Interim answer
    Docker Desktop / WSL2 with the published image (#41). That is the documented Windows path until this ships.
    Exit test
    The Linux E2E scenario passes on a Windows runner against the Chromium engine, and winget install headless works.
    Activity
    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
      area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command
      Type
      No type
      Projects
      Milestone
      Relationships
      None yet
      Development
      No branches or pull requests
      Issue actions
      
, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

      Skip to content
      W — Windows support (stretch): port surface and prerequisites #56
      Open
      1 of 1 issue completed
      Open
      W — Windows support (stretch): port surface and prerequisites#56
      1 of 1 issue completed
      Labels
      area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command
      Milestone
      Phase W — Windows (stretch)
      Description
      @yashranaway
      yashranaway
      opened on Aug 5, 2026
      Tracking issue for the Windows port. Not required for "done" — owner decision, 2026-08-04: later / best-effort. See architecture decisions §6 and ROADMAP Phase W.
      Blocked on
      Phase 2 — the HostCore + BrowserEngine extraction (#21) and typed errors (#22). Without that seam, Windows means a third hand-written copy of every command. Do not start before it lands.
      Shape of the work
      The WKWebView host is never ported. Windows runs the Chromium engine only.
      • Transport — named pipes with a SID-based peer check, replacing AF_UNIX + getpeereid/SO_PEERCRED. Windows has AF_UNIX, but no filesystem mode bits and no SO_PEERCRED, and the stale-socket probe does not map.
      • Runtime directory — %LOCALAPPDATA% with ACLs instead of /tmp/headless-<uid> at 0700.
      • Process spawn — CreateProcess + CreatePipe + SetHandleInformation. Chromium on Windows takes --remote-debugging-pipe handles via STARTUPINFO, not fds 3/4, so spawnChromium needs a Win32 rewrite.
      • CDP I/O — overlapped I/O or WaitForMultipleObjects instead of poll().
      • Artifact store — ACLs instead of POSIX modes; CREATE_NEW for the O_EXCL guarantee. Every "0600 in a 0700 dir" claim is POSIX-only today.
      • Signals — console control handler instead of SIGTERM/SIGINT dispatch sources.
      • Browser discovery — registry + Program Files, Edge as a candidate, ; PATH splitting.
      • FFmpeg discovery — .exe resolution under the same allow-list-not-PATH rule.
      • Elevation check — replace the getuid() != 0 root refusal with an elevated-token check.
      • Scripts — the build/test/E2E suite is POSIX sh; needs re-authoring.
      • Distribution — winget manifest (Phase 3 patterns apply).
      Already portable
      Protocol.swift, CLI.swift, AgentRuntime.swift (the injected JS is engine-agnostic), Diagnostics.swift, Flows.swift, CaptureFormats.swift, ScreenshotSeries.swift, MCP/main.swift, and Recording.swift modulo executable discovery.
      Interim answer
      Docker Desktop / WSL2 with the published image (#41). That is the documented Windows path until this ships.
      Exit test
      The Linux E2E scenario passes on a Windows runner against the Chromium engine, and winget install headless works.
      Activity
      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
        area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command
        Type
        No type
        Projects
        Milestone
        Relationships
        None yet
        Development
        No branches or pull requests
        Issue actions
        
, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

        Skip to content
        W — Windows support (stretch): port surface and prerequisites #56
        Open
        1 of 1 issue completed
        Open
        W — Windows support (stretch): port surface and prerequisites#56
        1 of 1 issue completed
        Labels
        area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command
        Milestone
        Phase W — Windows (stretch)
        Description
        @yashranaway
        yashranaway
        opened on Aug 5, 2026
        Tracking issue for the Windows port. Not required for "done" — owner decision, 2026-08-04: later / best-effort. See architecture decisions §6 and ROADMAP Phase W.
        Blocked on
        Phase 2 — the HostCore + BrowserEngine extraction (#21) and typed errors (#22). Without that seam, Windows means a third hand-written copy of every command. Do not start before it lands.
        Shape of the work
        The WKWebView host is never ported. Windows runs the Chromium engine only.
        • Transport — named pipes with a SID-based peer check, replacing AF_UNIX + getpeereid/SO_PEERCRED. Windows has AF_UNIX, but no filesystem mode bits and no SO_PEERCRED, and the stale-socket probe does not map.
        • Runtime directory — %LOCALAPPDATA% with ACLs instead of /tmp/headless-<uid> at 0700.
        • Process spawn — CreateProcess + CreatePipe + SetHandleInformation. Chromium on Windows takes --remote-debugging-pipe handles via STARTUPINFO, not fds 3/4, so spawnChromium needs a Win32 rewrite.
        • CDP I/O — overlapped I/O or WaitForMultipleObjects instead of poll().
        • Artifact store — ACLs instead of POSIX modes; CREATE_NEW for the O_EXCL guarantee. Every "0600 in a 0700 dir" claim is POSIX-only today.
        • Signals — console control handler instead of SIGTERM/SIGINT dispatch sources.
        • Browser discovery — registry + Program Files, Edge as a candidate, ; PATH splitting.
        • FFmpeg discovery — .exe resolution under the same allow-list-not-PATH rule.
        • Elevation check — replace the getuid() != 0 root refusal with an elevated-token check.
        • Scripts — the build/test/E2E suite is POSIX sh; needs re-authoring.
        • Distribution — winget manifest (Phase 3 patterns apply).
        Already portable
        Protocol.swift, CLI.swift, AgentRuntime.swift (the injected JS is engine-agnostic), Diagnostics.swift, Flows.swift, CaptureFormats.swift, ScreenshotSeries.swift, MCP/main.swift, and Recording.swift modulo executable discovery.
        Interim answer
        Docker Desktop / WSL2 with the published image (#41). That is the documented Windows path until this ships.
        Exit test
        The Linux E2E scenario passes on a Windows runner against the Chromium engine, and winget install headless works.
        Activity
        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
          area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command
          Type
          No type
          Projects
          Milestone
          Relationships
          None yet
          Development
          No branches or pull requests
          Issue actions
          
, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

          Skip to content
          W — Windows support (stretch): port surface and prerequisites #56
          Open
          1 of 1 issue completed
          Open
          W — Windows support (stretch): port surface and prerequisites#56
          1 of 1 issue completed
          Labels
          area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command
          Milestone
          Phase W — Windows (stretch)
          Description
          @yashranaway
          yashranaway
          opened on Aug 5, 2026
          Tracking issue for the Windows port. Not required for "done" — owner decision, 2026-08-04: later / best-effort. See architecture decisions §6 and ROADMAP Phase W.
          Blocked on
          Phase 2 — the HostCore + BrowserEngine extraction (#21) and typed errors (#22). Without that seam, Windows means a third hand-written copy of every command. Do not start before it lands.
          Shape of the work
          The WKWebView host is never ported. Windows runs the Chromium engine only.
          • Transport — named pipes with a SID-based peer check, replacing AF_UNIX + getpeereid/SO_PEERCRED. Windows has AF_UNIX, but no filesystem mode bits and no SO_PEERCRED, and the stale-socket probe does not map.
          • Runtime directory — %LOCALAPPDATA% with ACLs instead of /tmp/headless-<uid> at 0700.
          • Process spawn — CreateProcess + CreatePipe + SetHandleInformation. Chromium on Windows takes --remote-debugging-pipe handles via STARTUPINFO, not fds 3/4, so spawnChromium needs a Win32 rewrite.
          • CDP I/O — overlapped I/O or WaitForMultipleObjects instead of poll().
          • Artifact store — ACLs instead of POSIX modes; CREATE_NEW for the O_EXCL guarantee. Every "0600 in a 0700 dir" claim is POSIX-only today.
          • Signals — console control handler instead of SIGTERM/SIGINT dispatch sources.
          • Browser discovery — registry + Program Files, Edge as a candidate, ; PATH splitting.
          • FFmpeg discovery — .exe resolution under the same allow-list-not-PATH rule.
          • Elevation check — replace the getuid() != 0 root refusal with an elevated-token check.
          • Scripts — the build/test/E2E suite is POSIX sh; needs re-authoring.
          • Distribution — winget manifest (Phase 3 patterns apply).
          Already portable
          Protocol.swift, CLI.swift, AgentRuntime.swift (the injected JS is engine-agnostic), Diagnostics.swift, Flows.swift, CaptureFormats.swift, ScreenshotSeries.swift, MCP/main.swift, and Recording.swift modulo executable discovery.
          Interim answer
          Docker Desktop / WSL2 with the published image (#41). That is the documented Windows path until this ships.
          Exit test
          The Linux E2E scenario passes on a Windows runner against the Chromium engine, and winget install headless works.
          Activity
          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
            area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command
            Type
            No type
            Projects
            Milestone
            Relationships
            None yet
            Development
            No branches or pull requests
            Issue actions
            
, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

            Skip to content
            W — Windows support (stretch): port surface and prerequisites #56
            Open
            1 of 1 issue completed
            Open
            W — Windows support (stretch): port surface and prerequisites#56
            1 of 1 issue completed
            Labels
            area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command
            Milestone
            Phase W — Windows (stretch)
            Description
            @yashranaway
            yashranaway
            opened on Aug 5, 2026
            Tracking issue for the Windows port. Not required for "done" — owner decision, 2026-08-04: later / best-effort. See architecture decisions §6 and ROADMAP Phase W.
            Blocked on
            Phase 2 — the HostCore + BrowserEngine extraction (#21) and typed errors (#22). Without that seam, Windows means a third hand-written copy of every command. Do not start before it lands.
            Shape of the work
            The WKWebView host is never ported. Windows runs the Chromium engine only.
            • Transport — named pipes with a SID-based peer check, replacing AF_UNIX + getpeereid/SO_PEERCRED. Windows has AF_UNIX, but no filesystem mode bits and no SO_PEERCRED, and the stale-socket probe does not map.
            • Runtime directory — %LOCALAPPDATA% with ACLs instead of /tmp/headless-<uid> at 0700.
            • Process spawn — CreateProcess + CreatePipe + SetHandleInformation. Chromium on Windows takes --remote-debugging-pipe handles via STARTUPINFO, not fds 3/4, so spawnChromium needs a Win32 rewrite.
            • CDP I/O — overlapped I/O or WaitForMultipleObjects instead of poll().
            • Artifact store — ACLs instead of POSIX modes; CREATE_NEW for the O_EXCL guarantee. Every "0600 in a 0700 dir" claim is POSIX-only today.
            • Signals — console control handler instead of SIGTERM/SIGINT dispatch sources.
            • Browser discovery — registry + Program Files, Edge as a candidate, ; PATH splitting.
            • FFmpeg discovery — .exe resolution under the same allow-list-not-PATH rule.
            • Elevation check — replace the getuid() != 0 root refusal with an elevated-token check.
            • Scripts — the build/test/E2E suite is POSIX sh; needs re-authoring.
            • Distribution — winget manifest (Phase 3 patterns apply).
            Already portable
            Protocol.swift, CLI.swift, AgentRuntime.swift (the injected JS is engine-agnostic), Diagnostics.swift, Flows.swift, CaptureFormats.swift, ScreenshotSeries.swift, MCP/main.swift, and Recording.swift modulo executable discovery.
            Interim answer
            Docker Desktop / WSL2 with the published image (#41). That is the documented Windows path until this ships.
            Exit test
            The Linux E2E scenario passes on a Windows runner against the Chromium engine, and winget install headless works.
            Activity
            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
              area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command
              Type
              No type
              Projects
              Milestone
              Relationships
              None yet
              Development
              No branches or pull requests
              Issue actions
              
, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

              Skip to content
              W — Windows support (stretch): port surface and prerequisites #56
              Open
              1 of 1 issue completed
              Open
              W — Windows support (stretch): port surface and prerequisites#56
              1 of 1 issue completed
              Labels
              area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command
              Milestone
              Phase W — Windows (stretch)
              Description
              @yashranaway
              yashranaway
              opened on Aug 5, 2026
              Tracking issue for the Windows port. Not required for "done" — owner decision, 2026-08-04: later / best-effort. See architecture decisions §6 and ROADMAP Phase W.
              Blocked on
              Phase 2 — the HostCore + BrowserEngine extraction (#21) and typed errors (#22). Without that seam, Windows means a third hand-written copy of every command. Do not start before it lands.
              Shape of the work
              The WKWebView host is never ported. Windows runs the Chromium engine only.
              • Transport — named pipes with a SID-based peer check, replacing AF_UNIX + getpeereid/SO_PEERCRED. Windows has AF_UNIX, but no filesystem mode bits and no SO_PEERCRED, and the stale-socket probe does not map.
              • Runtime directory — %LOCALAPPDATA% with ACLs instead of /tmp/headless-<uid> at 0700.
              • Process spawn — CreateProcess + CreatePipe + SetHandleInformation. Chromium on Windows takes --remote-debugging-pipe handles via STARTUPINFO, not fds 3/4, so spawnChromium needs a Win32 rewrite.
              • CDP I/O — overlapped I/O or WaitForMultipleObjects instead of poll().
              • Artifact store — ACLs instead of POSIX modes; CREATE_NEW for the O_EXCL guarantee. Every "0600 in a 0700 dir" claim is POSIX-only today.
              • Signals — console control handler instead of SIGTERM/SIGINT dispatch sources.
              • Browser discovery — registry + Program Files, Edge as a candidate, ; PATH splitting.
              • FFmpeg discovery — .exe resolution under the same allow-list-not-PATH rule.
              • Elevation check — replace the getuid() != 0 root refusal with an elevated-token check.
              • Scripts — the build/test/E2E suite is POSIX sh; needs re-authoring.
              • Distribution — winget manifest (Phase 3 patterns apply).
              Already portable
              Protocol.swift, CLI.swift, AgentRuntime.swift (the injected JS is engine-agnostic), Diagnostics.swift, Flows.swift, CaptureFormats.swift, ScreenshotSeries.swift, MCP/main.swift, and Recording.swift modulo executable discovery.
              Interim answer
              Docker Desktop / WSL2 with the published image (#41). That is the documented Windows path until this ships.
              Exit test
              The Linux E2E scenario passes on a Windows runner against the Chromium engine, and winget install headless works.
              Activity
              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
                area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command
                Type
                No type
                Projects
                Milestone
                Relationships
                None yet
                Development
                No branches or pull requests
                Issue actions
                
, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

                Skip to content
                W — Windows support (stretch): port surface and prerequisites #56
                Open
                1 of 1 issue completed
                Open
                W — Windows support (stretch): port surface and prerequisites#56
                1 of 1 issue completed
                Labels
                area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command
                Milestone
                Phase W — Windows (stretch)
                Description
                @yashranaway
                yashranaway
                opened on Aug 5, 2026
                Tracking issue for the Windows port. Not required for "done" — owner decision, 2026-08-04: later / best-effort. See architecture decisions §6 and ROADMAP Phase W.
                Blocked on
                Phase 2 — the HostCore + BrowserEngine extraction (#21) and typed errors (#22). Without that seam, Windows means a third hand-written copy of every command. Do not start before it lands.
                Shape of the work
                The WKWebView host is never ported. Windows runs the Chromium engine only.
                • Transport — named pipes with a SID-based peer check, replacing AF_UNIX + getpeereid/SO_PEERCRED. Windows has AF_UNIX, but no filesystem mode bits and no SO_PEERCRED, and the stale-socket probe does not map.
                • Runtime directory — %LOCALAPPDATA% with ACLs instead of /tmp/headless-<uid> at 0700.
                • Process spawn — CreateProcess + CreatePipe + SetHandleInformation. Chromium on Windows takes --remote-debugging-pipe handles via STARTUPINFO, not fds 3/4, so spawnChromium needs a Win32 rewrite.
                • CDP I/O — overlapped I/O or WaitForMultipleObjects instead of poll().
                • Artifact store — ACLs instead of POSIX modes; CREATE_NEW for the O_EXCL guarantee. Every "0600 in a 0700 dir" claim is POSIX-only today.
                • Signals — console control handler instead of SIGTERM/SIGINT dispatch sources.
                • Browser discovery — registry + Program Files, Edge as a candidate, ; PATH splitting.
                • FFmpeg discovery — .exe resolution under the same allow-list-not-PATH rule.
                • Elevation check — replace the getuid() != 0 root refusal with an elevated-token check.
                • Scripts — the build/test/E2E suite is POSIX sh; needs re-authoring.
                • Distribution — winget manifest (Phase 3 patterns apply).
                Already portable
                Protocol.swift, CLI.swift, AgentRuntime.swift (the injected JS is engine-agnostic), Diagnostics.swift, Flows.swift, CaptureFormats.swift, ScreenshotSeries.swift, MCP/main.swift, and Recording.swift modulo executable discovery.
                Interim answer
                Docker Desktop / WSL2 with the published image (#41). That is the documented Windows path until this ships.
                Exit test
                The Linux E2E scenario passes on a Windows runner against the Chromium engine, and winget install headless works.
                Activity
                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
                  area:core-protocolHeadlessProtocol: wire protocol, validation, transportbacklogTracked in docs/roadmap/improvements-backlog.mdpriority:lowNice to havestatus:blockedWaiting on another item or an owner decisiontype:featureNew capability or command
                  Type
                  No type
                  Projects
                  Milestone
                  Relationships
                  None yet
                  Development
                  No branches or pull requests
                  Issue actions