Dengan background agents, kamu bisa memunculkan agen asinkron yang mengedit dan menjalankan kode di lingkungan remote. Lihat status mereka, kirim follow-up, atau ambil alih kapan saja.

​
Cara Menggunakan

Kamu bisa mengakses background agent dengan dua cara:
  1. Background Agent Sidebar: Pakai tab background agent di sidebar native Cursor untuk melihat semua background agent yang terkait dengan akun kamu, mencari agent yang sudah ada, dan memulai yang baru.
  2. Background Agent Mode: Tekan untuk mengaktifkan background agent mode di UI.
Setelah mengirim prompt, pilih agent kamu dari daftar untuk melihat status dan masuk ke mesin.

Background agent memerlukan penyimpanan data selama beberapa hari.

​
Feedback

Kirim feedback ke channel Discord kami #background-agent atau background-agent-feedback@cursor.com. Silakan kirim laporan bug, permintaan fitur, atau ide.

​
Setup

Background agent berjalan di mesin terisolasi berbasis Ubuntu secara default. Agen punya akses internet dan bisa menginstal paket.

​
Koneksi GitHub

Agent background bakal nge-clone repo lo dari GitHub dan kerja di branch terpisah, terus nge-push ke repo lo biar handoff-nya gampang. Kasih akses read-write ke repo lo (termasuk repo atau submodule yang jadi dependensi). Kita bakal dukung provider lain (GitLab, Bitbucket, dll.) ke depannya.
Konfigurasi Daftar Izin IP
Kalau organisasimu pakai fitur daftar izin IP GitHub, kamu perlu ngatur akses buat agen latar belakang. Lihat dokumentasi integrasi GitHub buat instruksi penyiapan lengkap, termasuk info kontak dan alamat IP.

​
Penyiapan Lingkungan Dasar

Untuk kasus yang lebih advanced, atur sendiri lingkungannya. Jalankan instance IDE yang terhubung ke mesin remote. Siapkan mesin kamu, install tools dan paket, lalu ambil snapshot. Konfigurasikan pengaturan runtime:
  • Perintah install dijalankan sebelum agent mulai dan menginstal dependensi runtime. Ini bisa berarti menjalankan npm install atau bazel build.
  • Terminal menjalankan proses background saat agent bekerja—misalnya menyalakan web server atau mengompilasi file protobuf.
Untuk kasus yang paling advanced, pakai Dockerfile buat penyiapan mesin. Dockerfile memungkinkan kamu menyiapkan dependensi level sistem: install versi compiler tertentu, debugger, atau ganti base OS image. Jangan COPY seluruh project—kita yang ngatur workspace dan checkout commit yang benar. Tetap lakukan instalasi dependensi di install script. Masukkan secret apa pun yang dibutuhin buat dev environment kamu—secret disimpan terenkripsi at rest (pakai KMS) di database kita dan disediakan ke environment agent di background. Penyiapan mesin ada di .cursor/environment.json, yang bisa kamu commit ke repo kamu (direkomendasikan) atau simpan secara privat. Alur setup bakal nuntun kamu bikin environment.json.

​
Perintah Maintenance

Saat nyiapin mesin baru, kita mulai dari environment dasar, lalu jalanin perintah install dari environment.json kamu. Perintah ini sama seperti yang developer jalanin saat pindah branch—buat nginstal dependency baru. Buat kebanyakan orang, perintah install itu npm install atau bazel build. Biar startup mesin cepat, kita nge-cache state disk setelah perintah install selesai jalan. Rancang supaya bisa dijalanin berkali-kali. Cuma state disk yang bakal tetap kepake dari perintah install—proses yang dimulai di sini nggak akan tetap hidup saat agent mulai jalan.

​
Perintah Startup

Setelah menjalankan install, mesin akan menyala dan kita menjalankan perintah start, lalu menjalankan semua terminals. Ini akan memulai proses yang harus tetap hidup saat agen berjalan. Perintah start sering kali bisa dilewati. Pakai ini kalau environment dev kamu bergantung pada Docker—taruh sudo service docker start di perintah start. terminals ditujukan untuk kode aplikasi. Terminal-terminal ini berjalan dalam sesi tmux yang bisa diakses kamu dan agen. Misalnya, banyak repo website menaruh npm run watch sebagai sebuah terminal.

​
Spesifikasi environment.json

File environment.json dapat terlihat seperti berikut: 
{
  "snapshot": "POPULATED_FROM_SETTINGS",
  "install": "npm install",
  "terminals": [
    {
      "name": "Run Next.js",
      "command": "npm run dev"
    }
  ]
}
Secara formal, spesifikasinya didefinisikan di sini.

​
Model

Hanya model yang kompatibel dengan Max Mode yang tersedia untuk agen latar belakang.

​
Harga

Pelajari lebih lanjut tentang harga Background Agent.

​
Keamanan

Background Agent tersedia dalam Privacy Mode. Kami tidak pernah melatih model menggunakan kodenya dan hanya menyimpan kode untuk menjalankan agent. Pelajari lebih lanjut tentang Privacy Mode. Yang perlu kamu tahu:
  1. Berikan hak baca-tulis ke aplikasi GitHub kami untuk repo yang mau kamu edit. Kami pakai ini untuk meng-clone repo dan membuat perubahan.
  2. Kode kamu berjalan di infrastruktur AWS kami dalam VM terisolasi dan disimpan di disk VM selama agent masih aktif/terakses.
  3. Agent punya akses internet.
  4. Agent menjalankan semua perintah terminal secara otomatis, sehingga bisa mengiterasi pengujian. Ini berbeda dengan foreground agent, yang butuh persetujuan pengguna untuk setiap perintah. Auto-run menimbulkan risiko eksfiltrasi data: penyerang bisa melakukan prompt injection, menipu agent untuk mengunggah kode ke situs berbahaya. Lihat penjelasan OpenAI tentang risiko prompt injection untuk background agent.
  5. Jika Privacy Mode dimatikan, kami mengumpulkan prompt dan environment pengembangan untuk meningkatkan produk.
  6. Jika kamu mematikan Privacy Mode saat memulai background agent lalu menyalakannya lagi saat agent berjalan, agent akan tetap melanjutkan dengan Privacy Mode nonaktif sampai selesai.

​
Pengaturan dashboard

Admin workspace bisa ngatur setelan tambahan dari tab Background Agents di dashboard.

​
Pengaturan Default

  • Model default – model yang dipakai saat sebuah run nggak nentuin model. Pilih model apa pun yang mendukung Max Mode.
  • Repositori default – kalau kosong, agen bakal minta kamu milih repo. Ngasih repo di sini bikin kamu bisa lewatin langkah itu.
  • Branch dasar – branch yang jadi basis fork agen saat bikin pull request. Biarkan kosong buat pakai branch default repositori.

​
Pengaturan Keamanan

Semua opsi keamanan memerlukan hak admin.
  • Pembatasan pengguna – pilih None (semua anggota bisa menjalankan agen latar belakang) atau Allow list. Saat disetel ke Allow list, kamu menentukan persis rekan tim mana yang bisa membuat agen.
  • Tindak lanjut tim – saat aktif, siapa pun di workspace bisa menambahkan pesan tindak lanjut ke agen yang dimulai orang lain. Matikan untuk membatasi tindak lanjut hanya untuk pemilik agen dan admin.
  • Tampilkan ringkasan agen – mengatur apakah Cursor menampilkan gambar perbedaan file (file diff) dan cuplikan kode milik agen. Nonaktifkan jika kamu tidak ingin menampilkan path file atau kode di sidebar.
  • Tampilkan ringkasan agen di kanal eksternal – memperluas toggle sebelumnya ke Slack atau kanal eksternal lain yang sudah kamu hubungkan.
Perubahan tersimpan seketika dan langsung berlaku untuk agen baru.