[Go to site: main page, start]
Skip to main content

Command Palette

Search for a command to run...

CLI

Menggunakan Agent di CLI

Mode

CLI mendukung mode yang sama seperti Editor. Beralih antar mode menggunakan perintah slash atau flag --mode.

Mode Rencana

Gunakan Mode Rencana untuk menyusun pendekatan sebelum mulai coding. Agent akan mengajukan pertanyaan klarifikasi untuk menyempurnakan rencana Anda.

  • Tekan Shift+Tab untuk beralih ke Mode Rencana
  • Gunakan /plan untuk beralih ke Mode Rencana
  • Mulai dengan flag --plan atau --mode=plan

Mode Ask

Gunakan mode Ask untuk menjelajahi kode tanpa membuat perubahan. Agent menelusuri codebase Anda dan memberikan jawaban tanpa mengedit file.

  • Gunakan /ask untuk beralih ke mode Ask
  • Mulai dengan flag --mode=ask

Memberikan prompt

Sampaikan tujuan dengan jelas untuk hasil terbaik. Misalnya, Anda dapat menggunakan prompt "jangan menulis kode apa pun" untuk memastikan agent tidak mengedit file apa pun. Ini umumnya membantu saat merencanakan tugas sebelum mengimplementasikannya.

Agent memiliki alat untuk operasi file, pencarian, menjalankan perintah shell, dan akses web.

MCP

Agent mendukung MCP (Model Context Protocol) untuk memperluas fungsionalitas dan integrasi. CLI akan otomatis mendeteksi dan menggunakan konfigurasi mcp.json Anda, sehingga Anda dapat memakai server MCP dan alat yang sama seperti yang telah diatur untuk Editor.

ACP

Agent juga mendukung ACP (Agent Client Protocol) untuk integrasi dengan klien kustom. Gunakan agent acp untuk menjalankan Cursor CLI sebagai server ACP melalui stdio dengan pesan JSON-RPC.

Aturan

Agent CLI mendukung sistem aturan yang sama seperti Editor. Anda dapat membuat aturan di direktori .cursor/rules untuk memberikan konteks dan panduan kepada agent. Aturan ini akan dimuat dan diterapkan secara otomatis berdasarkan konfigurasinya, sehingga Anda dapat menyesuaikan perilaku agent untuk berbagai bagian proyek atau jenis file tertentu.

Bekerja dengan agent

Navigasi

Akses pesan sebelumnya dengan tombol panah atas (ArrowUpArrow Up) untuk menelusurinya satu per satu.

Pintasan input

  • Shift+Tab — Beralih antar mode (Agent, Plan, Ask)
  • Shift+Enter — Menyisipkan baris baru alih-alih mengirimkan prompt, sehingga memudahkan penulisan prompt multi-baris.
  • Ctrl+D — Keluar dari CLI. Mengikuti perilaku shell standar dan perlu ditekan dua kali untuk keluar.
  • Ctrl+J atau +Enter — Alternatif universal untuk menyisipkan baris baru yang berfungsi di semua terminal.

Tinjau

Meninjau perubahan dengan Ctrl+R. Tekan i untuk menambahkan instruksi tindak lanjut. Gunakan ArrowUpArrow Up/ArrowDownArrow Down untuk menggulir, dan ArrowLeftArrow Left/ArrowRightArrow Right untuk beralih antarfile.

Memilih konteks

Pilih file dan folder untuk disertakan dalam konteks dengan @. Kosongkan ruang di jendela konteks dengan menjalankan /summarize. /compress tetap menjadi alias.

Serahkan ke agen cloud

Push percakapan Anda ke agen cloud dan biarkan terus berjalan saat Anda tidak aktif. Tambahkan & di awal pesan apa pun untuk mengirimkannya ke cloud. Lanjutkan kembali di web atau perangkat seluler melalui cursor.com/agents.

# Kirim task ke agen cloud di tengah percakapan& refactor the auth module and add comprehensive tests

Worktree CLI

Gunakan -w atau --worktree [name] untuk menjalankan agent di worktree Git baru, alih-alih mengedit checkout saat ini secara langsung. Cursor membuat checkout ini di ~/.cursor/worktrees/<reponame>/<name>, bersama worktree yang dibuat dari Editor. Jika name tidak diisi, Cursor akan membuatnya secara otomatis.

Cursor membersihkan worktree CLI dengan aturan retensi yang sama seperti worktree Editor. Untuk pengaturan dan batas pembersihan, lihat Bagaimana worktree lama dibersihkan?.

Gunakan --workspace <path> jika Anda memerlukan root repositori yang eksplisit. Jika tidak, CLI menggunakan direktori kerja saat ini. --worktree hanya mengubah lokasi agent melakukan pengeditan file dalam proyek tersebut.

# Buat worktree sementara dari repositori saat ini dengan nama yang dibuat otomatisagent --worktree "upgrade the test runner and fix any broken snapshots"# Buat worktree dengan nama tertentu dari repositori lainagent --workspace ~/src/my-app --worktree auth-fix "fix the flaky auth test and open a PR"

Riwayat

Lanjutkan thread yang sudah ada dengan --resume [thread id] untuk memuat konteks sebelumnya.

Untuk melanjutkan percakapan terbaru, gunakan agent resume, --continue, atau perintah slash /resume.

Anda juga dapat menjalankan agent ls untuk membuka chat sebelumnya dan melanjutkannya.

Persetujuan perintah

Sebelum menjalankan perintah terminal, CLI akan meminta Anda menyetujui (y) atau menolak (n) perintah tersebut.

Mode noninteraktif

Gunakan -p atau --print untuk menjalankan Agent dalam mode noninteraktif. Respons akan dicetak ke konsol.

Dalam mode noninteraktif, Anda dapat memanggil Agent tanpa interaksi. Dengan demikian, Agent dapat diintegrasikan ke dalam skrip, pipeline CI, dan sebagainya.

Anda dapat mengombinasikannya dengan --output-format untuk mengatur format output. Misalnya, gunakan --output-format json untuk output terstruktur yang lebih mudah diurai dalam skrip, atau --output-format text untuk output teks biasa dari respons akhir agent.