d5fd2e9366
Real-profile browsing (browser.use_real_profile) is meant to drive a COPY of the user's profile headlessly in the background so they can keep working while the agent acts on their behalf. Instead, on any host with a display it launched the user's real browser binary HEADED, popping a window that grabbed focus on every turn. Root cause: the native launch (which bypasses agent-browser's own launcher to avoid --use-mock-keychain dropping keychain-encrypted cookies) only added --headless=new when Linux had no DISPLAY/WAYLAND_DISPLAY. On a normal desktop the guard was false, so Chrome opened a visible window. Fix: launch headless by default on every platform. Chrome's NEW headless mode shares the profile's normal cookie store (unlike legacy --headless), and the cookie drop we guard against comes from --use-mock-keychain, not from headless — so real-profile auth still loads. Users who want to watch can opt in via the existing browser.headed / AGENT_BROWSER_HEADED toggle (honored for real-profile now, same as the rest of the browser stack); display-less hosts stay headless regardless so the launch doesn't die at startup. Live A/B on a real X seat: old argv mapped a Chrome window (focus steal), --headless=new mapped zero windows while still exposing a working CDP port. Updated the stale test that pinned 'never passes --headless' (a legacy-headless premise) to positively assert the chrome launch is --headless=new by default.
Website
This website is built using Docusaurus, a modern static website generator.
Installation
yarn
Local Development
yarn start
This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
Build
yarn build
This command generates static content into the build directory and can be served using any static contents hosting service.
Deployment
Using SSH:
USE_SSH=true yarn deploy
Not using SSH:
GIT_USER=<Your GitHub username> yarn deploy
If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.
Diagram Linting
CI runs ascii-guard to lint docs for ASCII box diagrams. Use Mermaid (````mermaid`) or plain lists/tables instead of ASCII boxes to avoid CI failures.