Linear から Background Agents をそのまま使えるよ。課題を Cursor にアサインするか、コメントで @Cursor をメンションしてね。

はじめよう

インストール

Linear 連携を有効にするには Cursor の管理者権限が必要だよ。ほかのチーム設定は管理者以外のメンバーでも使える。
  1. Cursor integrations に移動
  2. Linear の横にある Connect をクリック
  3. Linear ワークスペースを接続してチームを選択
  4. Authorize をクリック
  5. Cursor で残っている Background Agent のセットアップを完了:
    • GitHub を接続してデフォルトのリポジトリを選択
    • 従量課金を有効化
    • プライバシー設定を確認

アカウント連携

初回起動時に Cursor と Linear のアカウント連携を求められるよ。PR を作成するには GitHub の接続が必要。

使い方

課題を Cursor に割り当てるか、コメントで @Cursor をメンションしてね。Cursor が課題を解析して、開発作業以外は自動で除外するよ。

課題の割り当て

  1. Linear の課題を開く
  2. assignee フィールドをクリック
  3. 「Cursor」を選択
Linear で Cursor に課題を割り当てる

Cursor をメンション

新しいエージェントを割り当てたり、追加の指示を出すには、コメントで @Cursor をメンションしてね。例: @Cursor 上で説明した認証バグを修正して

ワークフロー

Background Agents は Linear 上でリアルタイムにステータスを表示し、完了すると自動で PR を作成するよ。進捗は Cursor ダッシュボード で確認できる。
Linear における Background Agent のステータス更新

フォローアップ手順

エージェントのセッションに返信すると、その内容がフォローアップとしてエージェントに送られるよ。実行中の Background Agent に追加の指示を出すには、Linear のコメントで @Cursor をメンションしてね。

設定

Dashboard → Background Agents から Background Agent の設定を行う。
設定場所説明
Default RepositoryCursor Dashboardプロジェクトのリポジトリが未設定の場合に使うプライマリリポジトリ
Default ModelCursor DashboardBackground Agents に使用する AI モデル
Base BranchCursor DashboardPR の作成元にするブランチ(通常は 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. Default repository: Cursor ダッシュボード設定で指定されたリポジトリ

リポジトリラベルの設定

Linear でリポジトリラベルを作成するには:
  1. Linear ワークスペースの Settings に移動
  2. Labels をクリック
  3. New group をクリック
  4. グループ名を “repo” にする(大文字小文字は不問だが、“repo” である必要がある。“Repository” などの別表記は不可)
  5. そのグループ内で、各リポジトリ用に owner/repo 形式のラベルを作成
これらのラベルを Issue または Project に割り当てることで、Background Agent が作業すべきリポジトリを指定できる。
Linear でリポジトリラベルを設定する