Skip to main content
Connecting Linear installs the QA Wolf app in your Linear workspace. That app is the QA Wolf agent, and there’s nothing else to turn on. It answers only in the Linear teams you choose. The same connection can also sync QA Wolf bug reports with a Linear team. That’s a separate feature with its own settings, covered in Bug reports and coverage requests.

Requirements

  • Access to a QA Wolf workspace
  • Issue tracker integrations in your QA Wolf plan. If Workspace settings → Integrations has no Issue tracking section, ask your QA Wolf representative.
  • A Linear workspace admin to approve the QA Wolf app

Connect Linear

1

Add the agent

Open Workspace settings → Integrations. Under Issue tracking, select Connect on the Linear card. In Linear, approve the QA Wolf app and choose which teams it can access.
2

Set up bug report sync

To have QA Wolf create Linear issues for bug reports, enter the Team name exactly as it appears in Linear. The team name is case sensitive.Enable Create bug report issue. Optionally set Label UUID and Assignee UUID to give newly created issues a default label and assignee.
A Linear workspace answers to one QA Wolf workspace: the one in your organization that connected Linear most recently. If a QA Wolf workspace in another organization already connected it, setting up the agent fails. Contact QA Wolf support.

Choose which teams can use the agent

When a Linear admin approves the QA Wolf app, Linear asks which teams it can access. The agent only works on issues in those teams. To change the teams later, a Linear admin opens Linear’s AI & Agents settings and edits QA Wolf under Installed Agents. QA Wolf picks up the change automatically.

What you can ask the agent

Mention QA Wolf in an issue comment, or delegate the issue to it. A delegated issue’s title and description are the request, so a comment is optional.
  • Test what the issue describes — “Add a flow that covers this.”
  • Fix a flow — “The signup flow started failing after this change. Fix it.”
  • Why a run failed — “Why did the checkout flows fail on staging this morning?”
  • Where things stand — “What’s the status of the latest runs?”
  • Run flows — “Run the billing flows on staging.”
The agent reads the issue’s title, description, status, labels, and earlier comments. It doesn’t see attachments. Guidance you write in Linear under Settings → Agents → Additional guidance applies too, unless it conflicts with QA Wolf’s own instructions. It never runs your application’s source code. Anyone in a Linear team the agent has access to can ask. They don’t need a QA Wolf account.

Agent notices

If the agent posts one of these notices, here’s what to do:

Agent doesn’t respond

If the agent doesn’t reply at all, check these:

Disconnect Linear

Under Workspace settings → Integrations, open the Linear card’s menu and select Configure. Disconnect Linear in the window that opens. To connect it again, select Connect on the card.

Bug reports and coverage requests

These come from the Linear connection, not from the agent.
  • Automatic issue handling. Creates Linear issues automatically when new bug reports are generated in QA Wolf.
  • Synchronization. Closing a bug report in QA Wolf closes the linked Linear issue, and closing, reopening, or updating the Linear issue updates QA Wolf.
  • Test creation requests. Add a QA Wolf label to a Linear issue, or assign it to a QA Wolf user, to automatically create a coverage request in QA Wolf. Matching ignores case and accepts qawolf or qa wolf.
Last modified on November 9, 2026