app
Pup - the AI's own browser
Public Made by Adomby adom
pup gives your AI a real browser on your desktop that it drives completely, in the background, signed in as you: windows that never jump in front of your work, one shared profile that learns your logins, and every window labeled on the taskbar with its AI thread's name.
← Commit history
v1.8.25: fix foreground-restore threading (getOrLaunchBrowser now receives foreground; 1.8.24 threw 'foreground is not defined' on every open)
4 files changed
+9−9
adom-bridge-puppeteer-manifest.json+5−5@@ -1,10 +1,10 @@ { "manifest_version": 1, "name": "puppeteer",- "version": "1.8.24",- "url": "https://wiki.adom.inc/download/adom/adom-desktop-puppeteer-bridge/1.8.24/adom-bridge-puppeteer-v1.8.24.zip",- "sha256": "938f873ad4b69df106022862653587745e47e007b35dd996234addd865061cd0",- "size": 154366,+ "version": "1.8.25",+ "url": "https://wiki.adom.inc/download/adom/adom-desktop-puppeteer-bridge/1.8.25/adom-bridge-puppeteer-v1.8.25.zip",+ "sha256": "67a25463ac14550b02676ddc1b79e67b603f5c6bb33e47f6f96544f0ee5efe72",+ "size": 154368, "verbPrefixes": [ "browser_", "desktop_recorder_",@@ -12,5 +12,5 @@ ], "healthEndpoint": "/status", "statusVerb": "browser_readiness",- "released_at": "2026-07-13T11:48:20Z"+ "released_at": "2026-07-13T11:52:31Z" }
src/BRIDGE_VERSION+1−1@@ -1 +1 @@-1.8.24+1.8.25
src/bridge.json+1−1@@ -2,7 +2,7 @@ "manifest_version": 1, "name": "puppeteer", "displayName": "Puppeteer (Chrome for Testing + Native)",- "version": "1.8.24",+ "version": "1.8.25", "description": "Drives a browser ALREADY on the machine — installed Chrome, else Microsoft Edge (every Windows PC ships with Edge) — launched with a FRESH isolated profile, so the common case has NO ~150 MB Chrome-for-Testing download and it never touches the user's real tabs/logins. Binds its local server to LOOPBACK (127.0.0.1) only, so no Windows Firewall 'allow Node through the firewall' prompt ever pops. Chrome for Testing is fetched only as a LAST RESORT if the machine has no Chromium browser at all. SPAWN-VERIFIED fallback: pup tries each detected browser (Chrome → Edge → CfT) and actually launches it, falling through to the next if one won't start (and handling browsers like Edge that relaunch onto another PID), so a corrupt/partial install never hard-fails an open. The browser that launches is cached as the default (persisted across restarts) so it isn't re-probed each time. On spawn the bridge SELF-WARMS: detects browsers + disk, and only if the box has no Chrome/Edge and no cached CfT does it background-fetch CfT so the first open is instant. browser_use pins a specific browser (chrome | edge | cft | auto); {browser:'chrome',install:true} downloads & installs REAL Google Chrome (user-scoped, no admin) on an Edge-only box. browser_readiness (READ-ONLY) reports which browser will be used + the full candidate list + the default + free disk. Every failure returns a specific errorCode + _hint (chrome_install_no_disk, chrome_download_network, chrome_install_permission, chrome_stable_not_detected, …). Launches with FULL browser permissions by default for full debug (strictPermissions:true opts out). Headful automation: open/close windows+tabs, navigate, screenshot, eval JS, record. pup is a GENERIC, non-profile browser only — every session is a fresh isolated Chrome/Edge process, never the user's real signed-in browser; profile defaults to sessionId. To drive the user's REAL Chrome/Edge (their profile, cookies, SSO), use the Adom browser EXTENSION's nbrowser_* verbs — a separate bridge, not pup's job.", "homepage": "https://wiki.adom.inc/adom/adom-desktop", "author": "Adom Inc.",
src/server.js+2−2@@ -1648,7 +1648,7 @@ async function setSessionWindowBounds(session, { x, y, width, height } = {}) { } catch (e) { console.error(`[bounds] setSessionWindowBounds failed: ${e.message}`); return false; } } -async function getOrLaunchBrowser(profileName, { freshProfile = false, strictPermissions = false, nativeSite = false } = {}) {+async function getOrLaunchBrowser(profileName, { freshProfile = false, strictPermissions = false, nativeSite = false, foreground = false } = {}) { // Check if browser already running for this profile. // isConnected() can be stale after laptop sleep/wake — the WebSocket hasn't // noticed the disconnect yet. Validate with a real CDP call (pages()) with@@ -2106,7 +2106,7 @@ async function launchSession(sessionId, url, { freshProfile = false, profile, st } // Get or launch Chrome for this profile- const browser = await getOrLaunchBrowser(profileName, { freshProfile, strictPermissions, nativeSite });+ const browser = await getOrLaunchBrowser(profileName, { freshProfile, strictPermissions, nativeSite, foreground }); // Prefer to REUSE the startup blank tab (every fresh Chrome opens one) instead // of creating a new tab and then closing the blank. The startup tab's URL