Konfigurasi terminal

Atur terminal Anda untuk mendapatkan pengalaman terbaik dengan Cursor CLI. Panduan ini membahas keybinding untuk input multibaris, mode Vim, dan sinkronisasi tema.

Mulai cepat

Jika Shift+Enter tidak berfungsi untuk membuat baris baru di terminal Anda, jalankan /setup-terminal untuk panduan mengonfigurasi alternatif:

/setup-terminal

Perintah ini mendeteksi terminal Anda dan memberikan petunjuk untuk mengonfigurasi Option+EnterAlt+Enter sebagai cara alternatif untuk menyisipkan baris baru.

Opsi universal

Metode ini berfungsi di semua terminal, termasuk sesi tmux, screen, dan SSH:

Dukungan Terminal

Dukungan bawaan untuk Shift+Enter

Terminal berikut mendukung Shift+Enter untuk baris baru tanpa konfigurasi tambahan:

• iTerm2 (macOS)
• Ghostty
• Kitty
• Warp
• Zed (terminal terintegrasi)

Memerlukan /setup-terminal

Terminal berikut memerlukan /setup-terminal untuk mengatur Option+EnterAlt+Enter agar membuat baris baru:

• Apple Terminal (macOS)
• Alacritty
• VS Code (terminal terintegrasi)

Terminal multiplexer

tmux dan screen mencegat Shift+Enter sebelum perintah tersebut mencapai aplikasi. Gunakan opsi universal sebagai gantinya:

• Ctrl+J — Berfungsi andal di semua sesi multiplexer
• \+Enter — Juga berfungsi di semua multiplexer

Mode Vim

Aktifkan keybinding Vim untuk navigasi dan pengeditan di area input CLI.

Aktifkan/nonaktifkan dengan perintah slash

/vim

Mengaktifkan atau menonaktifkan mode Vim untuk sesi saat ini dan menyimpan preferensi ini.

Konfigurasi di pengaturan

Tambahkan ke ~/.cursor/cli-config.json:

{  "version": 1,  "editor": { "vimMode": true },  "permissions": { "allow": [], "deny": [] }}

Mode

mode Vim menggunakan pengeditan berbasis mode:

• Mode normal — Menavigasi dan menjalankan perintah (default saat mode Vim diaktifkan)
• Mode sisip — Mengetik teks seperti biasa

Tekan Esc untuk kembali dari mode sisip ke mode normal.

Navigasi

Pengeditan

Memasuki mode sisip

Jumlah

Awali perintah dengan angka untuk mengulanginya. Misalnya, 3w maju 3 kata, sedangkan 2dd menghapus 2 baris.

Tema terminal

Cursor CLI otomatis mendeteksi skema warna terminal Anda dan menyesuaikan tampilannya.

Deteksi otomatis

CLI mendeteksi warna latar terminal Anda menggunakan urutan escape standar. Sebagian besar terminal modern mendukungnya:

• Terminal gelap → CLI menggunakan tema gelap
• Terminal terang → CLI menggunakan tema terang

Terminal dengan deteksi otomatis

Terminal berikut melaporkan skema warnanya dengan benar:

• iTerm2
• Ghostty
• Kitty
• Alacritty
• Apple Terminal
• Windows Terminal
• Terminal terintegrasi VS Code

Memaksa tema

Jika deteksi otomatis tidak berfungsi, Anda dapat menggantinya dengan variabel lingkungan:

# Paksa tema gelapexport COLORFGBG="15;0"# Paksa tema terangexport COLORFGBG="0;15"

Tambahkan ini ke profil shell Anda (.bashrc, .zshrc, dll.) agar diterapkan secara permanen.

Pemecahan masalah tema

Warna tampak tidak benar:

• Pastikan terminal Anda mendukung 256 warna atau true color
• Periksa apakah TERM sudah diatur dengan benar (misalnya, xterm-256color)
• Coba atur COLORFGBG secara eksplisit

Pengguna tmux:

• Tambahkan berikut ini ke .tmux.conf Anda agar deteksi warna diteruskan:

  set -g default-terminal "tmux-256color"
  set -ag terminal-overrides ",xterm-256color:RGB"
  

• Mulai ulang tmux setelah melakukan perubahan

Konfigurasi manual

Jika /setup-terminal tidak berfungsi di terminal Anda, Anda dapat mengatur keybinding secara manual.

Option+Enter untuk baris baru

Option+EnterAlt+Enter mengirimkan urutan escape khusus yang dikenali oleh Cursor CLI sebagai baris baru. Atur terminal Anda agar mengirim \x1b\r (Escape diikuti carriage return) saat Option+EnterAlt+Enter ditekan.

iTerm2:

1. Buka Preferences → Profiles → Keys → Key Mappings
2. Klik + untuk menambahkan mapping baru
3. Atur Keyboard Shortcut ke Option+EnterAlt+Enter
4. Atur Action ke "Send Escape Sequence"
5. Masukkan \r sebagai urutan escape

Alacritty:

Tambahkan ke alacritty.toml Anda:

[keyboard]bindings = [  { key = "Return", mods = "Alt", chars = "\u001b\r" }]

Kitty:

Tambahkan ke kitty.conf Anda:

map alt+enter send_text all \x1b\r

Shift+Enter

Dukungan untuk Shift+Enter bergantung pada kemampuan terminal Anda untuk melaporkan tombol pengubah dengan benar. Sebagian besar terminal modern menanganinya secara otomatis, tetapi beberapa mungkin memerlukan konfigurasi.

Terminal VS Code:

Terminal terintegrasi VS Code mungkin tidak meneruskan Shift+Enter dengan benar. Tambahkan berikut ini ke keybindings.json Anda:

{  "key": "shift+enter",  "command": "workbench.action.terminal.sendSequence",  "args": { "text": "\u001b[13;2u" },  "when": "terminalFocus"}

Pemecahan masalah

Keybinding tidak berfungsi:

• Verifikasi bahwa terminal Anda mendeteksi key dengan benar menggunakan cat atau showkey
• Periksa apakah terminal multiplexer (tmux/screen) mengintersep key
• Gunakan Ctrl+J sebagai alternatif andal

Pengguna tmux:

• Shift+Enter dan Option+EnterAlt+Enter tidak berfungsi melalui tmux
• Sebagai gantinya, gunakan Ctrl+J atau \+Enter
• Opsi universal ini berfungsi di mana saja, termasuk dalam sesi tmux bertingkat

Sesi SSH:

• Kemampuan terminal remote bergantung pada emulator terminal lokal Anda
• Ctrl+J berfungsi dengan andal melalui SSH
• \+Enter merupakan opsi andal lainnya

Ringkasan