Help & Getting Started
One-click bug reports that ship with a runnable regression test.
Capture a bug
- On the page where the bug happens, click the Gotcha toolbar icon — or press Ctrl+Shift+Y (⌘+Shift+Y on Mac).
- Press Capture this bug. Gotcha bundles the screenshot, console errors, failed network requests, a DOM snapshot, and your recent steps.
- The Review screen opens so you can edit and redact before filing.
Record reproduction steps
Click Start a recording session to capture the exact clicks and inputs that trigger the bug. Those steps become the reproduction in your ticket — and the basis for a generated Playwright regression test.
Deep capture (optional)
Enable Deep capture in the popup to record full network response bodies and requests that fired before the page loaded. It uses Chrome's debugger and shows a debug banner while active. It is off by default and only attaches when you turn it on.
Connect an issue tracker
Open Settings to connect where reports are filed:
- Linear — personal API key and target team id.
- Jira — Atlassian Cloud site, email, API token, project key.
- GitHub — fine-grained PAT (Issues: write) and the repo.
- Slack — an Incoming Webhook URL.
Privacy & redaction
Redaction of secrets (auth headers, cookies, tokens, emails, card numbers, password fields) is on by default on every report. Add your own redaction patterns or block specific domains in Settings. Captures stay on your device until you file them. See the Privacy Policy for details.
AI assistant (optional)
On the review screen you can ask an LLM to summarise the bug and suggest debugging steps. Gotcha uses your own API key (OpenAI, Anthropic, or Google Gemini) and the report is always redacted before it is sent.