Skip to content

Make Helium the browser these configs drive - #68

Merged
sanketsudake merged 2 commits into
mainfrom
helium-default-browser
Aug 29, 2026
Merged

Make Helium the browser these configs drive#68
sanketsudake merged 2 commits into
mainfrom
helium-default-browser

Conversation

@sanketsudake

Copy link
Copy Markdown
Owner

The day-to-day browser with the live SSO logins is Helium (a Chromium fork), not Google Chrome.
chrome-cdp doctor and agent-browser --cdp 9222 default to Chrome's DevToolsActivePort,
which is stale or absent, so the attach fails with connection_failed;
launching Chrome instead opens an empty profile with none of the logins.

Changes

  • claude/CLAUDE.md — the "Interacting with browser" section is Helium-first:
    the helium://inspect/#remote-debugging toggle (no restart, tabs and logins survive),
    the DevToolsActivePortws:// endpoint recipe,
    and chrome-cdp daemon start --endpoint so the consent prompt is answered once per session.
  • login-microsoft-sso — attach through Helium's endpoint before doctor,
    because doctor reads Chrome's port file by default.
  • Workday / Engage / Outlook skills — "the user's real Chrome" → "the user's real browser",
    so the prose no longer names the wrong application.
    The chrome-cdp tool name is unchanged.

Verification

make preflight and make test pass.

The day-to-day browser with the live SSO logins is Helium, a Chromium
fork, not Google Chrome. Chrome's DevToolsActivePort is stale, so the
default attach path fails and launching Chrome opens an empty profile.

- claude/CLAUDE.md: Helium-first browser section — the
  helium://inspect/#remote-debugging toggle, the DevToolsActivePort ->
  ws:// endpoint recipe, and daemon start --endpoint for one consent
  prompt per session.
- login-microsoft-sso: attach through Helium's endpoint before doctor.
- Workday/Engage/Outlook skills: "real Chrome" -> "real browser" so the
  prose no longer names the wrong application.
The shared CLAUDE.md loads into every session, so it states policy, not
mechanics. The endpoint recipe becomes a script both the rules and the
skills call by path.

- claude/scripts/browser-endpoint.sh: prints the CDP endpoint, exits 1
  with an instruction when the port file is absent.
- claude/CLAUDE.md: browser section cut from 25 lines to 10 — which
  browser, attach do not launch, which tool, one consent prompt, no
  credentials.
- login-microsoft-sso: calls the script instead of repeating the recipe.
@sanketsudake sanketsudake reopened this Aug 29, 2026
@sanketsudake
sanketsudake merged commit 1cf29b8 into main Aug 29, 2026
3 checks passed
@sanketsudake
sanketsudake deleted the helium-default-browser branch August 29, 2026 07:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant