Index of every page on this site: llms.txt
All skills
getsentry avatar

/browse-local-sentry

@a582c51 official
by Sentrygetsentry/skills1.2k stars
71
Run it yourself

Connects an agent's browser to a local Sentry dev server (dev-ui on *.dev.getsentry.net or the full devserver).

Use this Skill: https://skilld.dev/gh/getsentry/skills/browse-local-sentry

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SPEC.md

≈644 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Browse Local Sentry Specification

Intent

Get an agent's browser onto a local Sentry dev server, trusted and signed in, so it can QA and screenshot the real product. Agents otherwise hit an untrusted certificate or a login wall they cannot pass, then report "browser verification was blocked" instead of doing the QA.

Scope

In scope:

  • Finding the dev-ui or devserver URL and port.
  • The mkcert certificate dev-ui needs.
  • Attaching chrome-devtools-mcp to the user's own Chrome for dev-ui.
  • Checking and fixing authentication.
  • Safety limits for production data and the user's real browser.

Out of scope:

  • Installing or running the dev environment (devenv, devservices).
  • Screenshot framing, tables, and upload (pr-screenshots).
  • Seeding data for a specific state.

Should Not Trigger For

  • Browsing production sentry.io or other sites.
  • Writing Jest or Playwright tests.
  • Dev environment setup failures before a server is running.

Acceptance Gates

  • dev-ui runs in the user's existing Chrome, never a launched profile.
  • No mutating actions against production through dev-ui without approval.
  • The user's own tabs are never read, navigated, closed, or quoted. Attaching may load discarded tabs, which the skill cannot prevent.
  • Never bypasses certificate warnings or adds insecure-cert flags.
  • Never logs in to sentry.io or types the user's credentials.
  • Changes MCP config only with the user's approval, at a pinned version.
  • Verifies attachment with list_pages and auth with /api/client-config/.
  • Reports the blocked step and the user's action instead of claiming QA.

Known Limitations

  • Remote debugging, the Chrome connection prompt, mkcert -install, and sign-in all need the user. The skill can only detect and ask.
  • --autoConnect needs a locally running Chrome 144+. Sandboxed clients must use --browser-url, which Chrome only allows with a separate profile, so they lose the signed-in session and can only use the full devserver.
  • Sentry Cookie Sync learns orgs only from open :7999 dev-ui tabs and *.sentry.io tabs. dev-ui on other ports depends on an open sentry.io tab.
  • Other tools that drive the user's real Chrome, such as browser extensions, should work from Step 4 on but are untested.

Maintenance Notes

Re-check SOURCES.md facts when dev-ui's HTTPS or proxy setup, the mkcert-localhost script, Sentry Cookie Sync, or chrome-devtools-mcp's connection flags change.

Bump the pinned chrome-devtools-mcp version only after reviewing the release, and re-run Steps 3 and 4 against it.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts15d3 checks · Risk SAFE
  • Gen Agent Trust Hub15d

    This skill provides a safe and well-documented workflow for Sentry developers to connect an agent to their local development environment. It uses standard diagnostic tools and version-pinned browser automation via an MCP server. Security is maintained through explicit safety rules, constraints on production data access, and requirements for user approval before making persistent configuration changes.

  • Socket15d

    No alerts

  • Snyk15d

    Risk: LOW · No issues

Signed by skilld at a582c51. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 6 days ago.

Activeupdated 4 weeks ago

README badge

README badge for getsentry/skills/browse-local-sentry