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.
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.”
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
qawolforqa wolf.