Langsung ke konten utama
Pakai Background Agents langsung dari Linear dengan mendelegasikan isu ke Cursor atau menyebut @Cursor di komentar.

Mulai

Instalasi

Kamu harus jadi admin Cursor untuk menyambungkan integrasi Linear. Pengaturan tim lainnya tersedia untuk anggota non-admin.
  1. Buka integrasi Cursor
  2. Klik Connect di samping Linear
  3. Sambungkan workspace Linear kamu dan pilih tim
  4. Klik Authorize
  5. Selesaikan sisa pengaturan Background Agent di Cursor:
    • Sambungkan GitHub dan pilih repositori default
    • Aktifkan penagihan berbasis penggunaan
    • Konfirmasi pengaturan privasi

Penautan akun

Pertama kali dipakai, kamu akan diminta menautkan akun Cursor dan Linear. Koneksi GitHub diperlukan untuk membuat PR.

Cara menggunakan

Delegasikan issue ke Cursor atau mention @Cursor di komentar. Cursor bakal menganalisis issue dan otomatis nyaring pekerjaan non-development.

Mendelegasikan issue

  1. Buka issue di Linear
  2. Klik field assignee
  3. Pilih “Cursor”
Mendelegasikan issue ke Cursor di Linear

Mention Cursor

Mention @Cursor di komentar buat nge-assign agen baru atau kasih instruksi tambahan, misalnya: @Cursor tolong perbaiki bug autentikasi yang dijelaskan di atas.

Alur kerja

Background Agent menampilkan status real-time di Linear dan otomatis bikin PR saat selesai. Lacak progres di dashboard Cursor.
Pembaruan status Background Agent di Linear

Instruksi tindak lanjut

Lo bisa balas di sesi agent dan pesannya bakal dikirim sebagai tindak lanjut ke agent. Cukup mention @Cursor di komentar Linear buat ngasih panduan tambahan ke Background Agent yang lagi jalan.

Konfigurasi

Atur pengaturan Background Agent dari Dashboard → Background Agents.
SettingLocationDescription
Default RepositoryCursor DashboardRepository utama saat nggak ada repository proyek yang dikonfigurasi
Default ModelCursor DashboardModel AI untuk Background Agents
Base BranchCursor DashboardBranch asal untuk membuat PR (umumnya main atau develop)

Opsi konfigurasi

Kamu bisa ngatur perilaku Background Agent lewat beberapa cara: Deskripsi issue atau komentar: Pakai sintaks [key=value], misalnya:
  • @cursor please fix [repo=anysphere/everysphere]
  • @cursor implement feature [model=claude-3.5-sonnet] [branch=feature-branch]
Label issue: Pakai struktur label induk–anak, di mana label induk adalah key konfigurasi dan label anak adalah valuenya. Label proyek: Struktur induk–anak yang sama seperti label issue, diterapkan di level proyek. Key konfigurasi yang didukung:
  • repo: Tentukan repository target (misalnya, owner/repository)
  • branch: Tentukan base branch untuk pembuatan PR
  • model: Tentukan model AI yang dipakai

Pemilihan repository

Cursor nentuin repository yang akan dikerjain pakai urutan prioritas ini:
  1. Deskripsi/komentar issue: Sintaks [repo=owner/repository] di teks issue atau komentar
  2. Label issue: Label repository yang ditempel ke issue Linear tersebut
  3. Label proyek: Label repository yang ditempel ke proyek Linear
  4. Default repository: Repository yang disetel di pengaturan Cursor Dashboard

Menyiapkan label repository

Buat label repository di Linear dengan langkah berikut:
  1. Buka Settings di workspace Linear kamu
  2. Klik Labels
  3. Klik New group
  4. Kasih nama grup “repo” (nggak case-sensitive — harus persis “repo”, bukan “Repository” atau variasi lain)
  5. Di dalam grup itu, buat label untuk tiap repository pakai format owner/repo
Label ini bisa kamu pasang ke issue atau proyek buat nunjukin repository tempat Background Agent bakal kerja.
Mengonfigurasi label repository di Linear
I