Skip to main content
The Linear integration turns a Problem into a Linear issue that carries its cause, impact, and evidence, and keeps the two in step: completing the issue marks the Problem fixed, and if Moda sees the Problem come back, the issue reopens with the new evidence. It is in preview; ask Moda support to enable it for your workspace.

​
Connect Linear

  1. Open Integrations and select Connect Linear. Only workspace admins can connect.
  2. Approve the Moda app in Linear. Moda is installed as an app, so issues and comments are authored by Moda and show “Your name (via Moda)” when you file them, and the integration keeps working if the person who connected it leaves.
  3. Back on Integrations, choose the team Problems are filed in. Optionally pick a project and labels, and decide how Linear status flows back:
Disconnect revokes Moda’s access in Linear and deletes the stored credentials. Existing issues stay in Linear; their status stops syncing until you reconnect.

​
File a Problem

On a Problem, select Create Linear issue. Edit the title, team, and priority, then Create issue. The issue contains:
  • the cause statement and current impact (users, traces, rank, status),
  • the top five pieces of evidence, each linked to its trace,
  • a link back to the Problem, attached to the issue.
Each Problem has at most one issue. Filing again, from another tab, the CLI, or an automation, returns the issue that already exists. To track a Problem with an issue your team already has, switch to Existing issue and paste its ID (ENG-123) or URL. The chip in the Problem header shows the issue’s live Linear state; Unlink issue removes Moda’s attachment and leaves the issue in Linear.

​
How status syncs

Moda-to-Linear updates run every 15 minutes. Linear-to-Moda changes are recorded immediately and applied at the next analysis run.

​
Ask @Moda in Linear

Mention @Moda in a comment on an issue (or delegate the issue to Moda) to get the linked Problem’s current status, impact, cause, and top evidence. Mention @Moda with a Problem’s URL to link an issue your team filed by hand to that Problem.

​
Automations

With both Slack automations and Linear enabled, an automation can file in Linear instead of posting to Slack. Choose Linear as the destination and pick a team and priority:
  • Problem automations (New problem, Problem gets worse) use the Problem’s one issue: the first alert files it, later alerts comment on it.
  • Other alerts file one issue each, and a recovery comments on the issue its alert filed.

​
CLI and MCP

  • moda problem-linear <problem_id> (MCP problem_linear) shows the linked issue.
  • moda problem-linear-file <problem_id> (MCP problem_linear_file) files the issue, or links one with --issue=ENG-123.
Both use your API key and need the integration connected. See the parity map.