Diffs Integrations

Review Platform⁠

On behalf of attribution⁠

Pull request activity can show when a comment was made by an AI coding agent on behalf of a person. This attribution makes it clear which agent produced the comment and, when available, the model it used.

You’ll see the agent’s name and avatar alongside the comment, helping reviewers understand the source of the feedback or update. Supported agents include Claude Code, Codex, Linear, Pi, and OpenCode.

On behalf of attribution example

<!-- linear:extension {
  "version": 1,
  "plugins": [
    {
      "plugin": "onBehalfOf",
      "agent": "codex",
      "model": "gpt-5"
    }
  ]
} -->

• agent is required. Supported values are claude, codex, linear, pi, and opencode; other values are shown as a generic agent.
• model is optional and can be up to 200 characters.

Multiple plugins can be included in the same block. Extension-only comments are hidden from Linear by default. Add "visible":true to preserve the GitHub comment in the activity feed. On-behalf-of blocks are visible by default unless "visible":false is set.

Risk score⁠

Risk scores help reviewers quickly assess the potential impact of a pull request. When a connected provider supplies a score, Linear displays one of four levels:

Low risk, Typical risk, High risk, Very high risk

The score may also include an explanation, along with who reported it and when it was last updated. Use this context to prioritize review attention, it complements, rather than replaces, your team’s normal review process.

Risk score example

<!-- linear:extension {
  "version": 1,
  "plugins": [
    {
      "plugin": "riskScore",
      "sha": "0123456789abcdef0123456789abcdef01234567",
      "level": 3,
      "explanations": [
        "Touches authentication",
        "Changes database migrations"
      ]
    }
  ]
} -->

• level is required and must be an integer from 1 (low risk) to 4 (very high risk).
• sha is optional and must be a 40-character commit SHA. Omit it to apply the score to the pull request’s current revision.
• explanations is optional: up to 8 non-empty strings, each up to 200 characters.

Add data from GitHub⁠

Connected tools can add this metadata in an HTML comment on a GitHub pull request, review, or review comment. Use a linear:extension block with version 1 and one or more plugins:

<!-- linear:extension {"version":1,"plugins":[...]} -->

⁠