Skip to main content
Connect Linear and any finding becomes a Linear issue in two clicks: an issue, a UI/UX suggestion or a failed criterion in a run report. If your team already tracks it, link the existing issue instead, and its Linear status shows next to the finding.

​
Connect Linear

1

Open Integrations

Go to Settings → Integrations (also reachable from an app’s App settings → Integrations). A workspace owner or admin can connect Linear.
2

Authorize Minitap

Click Connect on the Linear row and approve access with your Linear account. Minitap lists the teams that account can see.
You can also connect from a finding: before any tracker is connected, its Ticket menu offers Connect Linear, and the ticket form opens again when you come back.

​
File an issue from a finding

1

Open the Ticket menu

Click Ticket on the issue, the UI/UX suggestion or the failed criterion. With several trackers connected, pick Linear at the top of the menu.
2

Create a new issue

Click Create a new Linear ticket, then pick the Team: type a few letters to search your teams. Minitap loads that team’s fields.
3

Check the fields and create

Adjust what Minitap preset, then click Create ticket in Linear. The finding now shows the issue’s key and status, and links to it.
Minitap presets the fields so the issue lands ready to pick up. You only see the fields your team has:

​
What the issue contains

For an issue or a failed criterion, the Linear issue is titled with what went wrong and holds:
  • A View in Minitap link and a Watch the recording link.
  • What happened, in Mini’s words.
  • Root cause analysis, with the steps to reproduce, the expected and actual behavior when Mini wrote them down.
  • A Context table: the scenario, the acceptance criterion, the platform, the build and the severity.
For a UI/UX suggestion, it holds what Mini found, the screen, the kind of suggestion, its severity, the scenarios it was seen in, the platform, Mini’s notes, and a View in Minitap link. Open the Ticket menu and search instead of creating: type an issue key (ENG-142), a few words, or paste the issue’s link. With an empty search, the menu shows the recently updated issues. Pick one and the finding is linked to it. A finding holds one ticket at a time. To change it, open the issue in the Issues tab and click Unlink ticket: the link goes, and the issue stays in Linear.

​
Status in Minitap

Every linked finding shows the issue’s key and its current Linear status, such as ENG-142 · In Progress, and opens the issue in Linear on click. Minitap reads the status from Linear each time it shows it. If the issue was deleted in Linear, Minitap drops the link. The finding keeps its own triage status in Minitap: triage it in the Issues tab.

​
From the CLI

The same actions work from the minitest CLI, for scripts and coding agents:
issues ticket fields linear --target <team-id> lists the fields you can set with --field KEY=VALUE. See the CLI reference.

​
Next steps

Triage issues

Decide which failures deserve a ticket.

UI/UX suggestions

The polish ideas Mini flags while it tests.

Jira

The same tickets in Jira, plus @Mini in comments.

Notion

Specs for Mini to read, and findings filed as pages.