跳转到主要内容
在 Linear 里直接用 Background Agents：把 issue 分配给 Cursor，或在评论里提及 @Cursor。

​
入门

​
安装

只有 Cursor 管理员才能连接 Linear 集成。其他团队设置对非管理员成员也可用。
  1. 前往 Cursor 集成
  2. 点击 Linear 旁边的 Connect
  3. 连接你的 Linear 工作区并选择团队
  4. 点击 Authorize
  5. 在 Cursor 中完成剩余的 Background Agent 设置：
    • 连接 GitHub 并选择默认仓库
    • 启用按用量计费
    • 确认隐私设置

​
账户关联

首次使用时会在 Cursor 和 Linear 之间触发账户关联。创建 PR 需要已连接 GitHub。

​
使用方式

把 issue 委派给 Cursor，或在评论中 @@Cursor。Cursor 会分析 issue，并自动过滤非开发类工作。

​
委派 issue

  1. 打开 Linear issue
  2. 点击 assignee 字段
  3. 选择 “Cursor”
在 Linear 中将 issue 委派给 Cursor

​
提及 Cursor

在评论中提及 @Cursor 来指派新的代理，或补充进一步指令，例如：@Cursor 修复上面提到的身份验证 bug。

​
工作流程

Background Agents 会在 Linear 中显示实时状态，并在完成后自动创建 PR。你可以在 Cursor dashboard 跟踪进度。
Background Agent 在 Linear 中的状态更新

​
后续指令

你可以在 agent 会话中直接回复，消息会作为后续内容发送给 agent。只需在 Linear 的评论里 @Cursor，就能为正在运行的 Background Agent 提供更多指导。

​
配置

在 Dashboard → Background Agents 配置 Background Agent。
SettingLocationDescription
Default RepositoryCursor Dashboard未配置项目仓库时使用的默认仓库
Default ModelCursor DashboardBackground Agents 使用的 AI 模型
Base BranchCursor Dashboard用于创建 PR 的基础分支（通常是 main 或 develop）

​
配置选项

可以通过多种方式配置 Background Agent 的行为： Issue 描述或评论：使用 [key=value] 语法，例如：
  • @cursor please fix [repo=anysphere/everysphere]
  • @cursor implement feature [model=claude-3.5-sonnet] [branch=feature-branch]
Issue 标签：使用父子标签结构，父标签为配置键，子标签为取值。 Project 标签：与 issue 标签相同的父子结构，在项目级应用。 支持的配置键：
  • repo：指定目标仓库（例如 owner/repository）
  • branch：指定创建 PR 的基础分支
  • model：指定要使用的 AI 模型

​
仓库选择

Cursor 按以下优先级确定要处理的仓库：
  1. Issue 描述/评论：issue 文本或评论中的 [repo=owner/repository] 语法
  2. Issue 标签：附加到具体 Linear issue 的仓库标签
  3. Project 标签：附加到 Linear 项目的仓库标签
  4. 默认仓库：在 Cursor Dashboard 设置中指定的仓库

​
设置仓库标签

在 Linear 中创建仓库标签：
  1. 进入 Linear 工作区的 Settings
  2. 点击 Labels
  3. 点击 New group
  4. 将分组命名为 “repo”（不区分大小写——必须是 “repo”，不能是 “Repository” 或其他变体）
  5. 在该分组下，为每个仓库按 owner/repo 格式创建标签
随后可以将这些标签分配给 issue 或项目，用于指定 Background Agent 应处理的仓库。
在 Linear 中配置仓库标签