How it works

A smart Chrome extension designed to speed up bug reporting for QA teams with clear, structured Jira tickets.

How FlawFerret Works

FlawFerret helps teams turn exploratory testing into clear, actionable Jira tickets in minutes. It combines a Chrome extension for fast UI capture with an optional AI service that can draft test scenarios for you.

Typical workflow

1. On any page, right-click a target element and choose FlawFerret.

2. FlawFerret opens an overlay with captured context:

   • URL and page title

   • element details and selector suggestions

   • optional snapshot

3. Edit details as needed.

4. Optional: click Generate with AI to create a draft scenario.

5. Optional: click Record Tab to capture a short repro flow.

6. Click Create Jira Ticket to submit the issue with context and attachments.

Why teams use FlawFerret

• Faster bug reporting with less manual copy/paste

• Better issue quality with consistent context

• Optional AI assistance without forcing cloud-only workflows

• Cleaner handoff from QA to engineering

The two parts of FlawFerret

FlawFerret includes:

1. FlawFerret Chrome Extension
   This is what users interact with in the browser. It captures page and element context, supports tab recording, and creates Jira issues.

2. FlawFerret AI Server (optional)
   This powers the “Generate with AI” feature. It can route requests to either OpenAI or a local Ollama model.

You can use FlawFerret without the AI server for core workflows, including context capture, recording, and Jira creation.

Install the extension

Install FlawFerret from the Chrome Web Store (recommended).
For development or private use, load the built dist folder as an unpacked extension in chrome://extensions.

Install the AI server (optional)

If you want AI scenario generation:

• Run the FlawFerret AI Server locally or host it in your environment.

• Set the extension’s AI Server URL in FlawFerret settings.

• Choose your provider in FlawFerret settings:

  • OpenAI (with server-side API key), or

  • Ollama (local model endpoint)

• Get the AI server here: https://github.com/rgmichaels/flawferretAIserver

  • See readme for installation instructions

Architecture at a glance

• Extension handles capture, UX, and Jira submission.

• AI Server handles generation requests (/health and /generate-scenario).

• Provider choice is configurable per environment (OpenAI or Ollama).

Need help setting it up?

If you want FlawFerret deployed for your team, you can run the AI server locally, host it privately, or run it in Docker. The extension works in all cases and can be configured to point to your chosen server URL.