Pemecahan Masalah: Terminal

Atasi masalah terminal yang umum — output kosong, masalah saat mengetik, dan gangguan pada agen AI.

Terminal Terbuka tetapi Tidak Ada Output Saat Mengetik

Gejala: Anda menekan tombol tetapi tidak ada yang muncul di terminal, atau terminal terbuka dengan layar kosong dan tetap seperti itu.

Kemungkinan penyebab dan solusi:

Kesalahan pada file init shell. File startup shell Anda (.zshrc, .bashrc, atau .bash_profile) mungkin memiliki kesalahan sintaks atau perintah yang menggantung. Buka terminal Bash biasa di 1DevTool lalu jalankan:

bash
cat ~/.zshrc

Cari kesalahan yang jelas — tanda kutip penutup yang hilang, variabel yang belum didefinisikan, atau perintah source yang mengarah ke file yang tidak ada. Perbaiki kesalahan tersebut di Env Manager atau editor teks, lalu buka kembali terminal.

Tipe terminal salah. Jika Anda memilih terminal “Claude Code” tetapi CLI claude belum terinstal, terminal akan terbuka tetapi shell gagal meluncurkan agen. Instal Claude Code terlebih dahulu (npm install -g @anthropic-ai/claude-code), atau ganti tipe terminal ke sesi Bash atau Zsh biasa.

Reset cepat. Klik kanan di mana saja pada tab terminal lalu pilih Restart Terminal. Ini menghentikan proses shell saat ini dan memulai yang baru tanpa menutup panel.


Agen AI Tidak Merespons Input

Gejala: Anda mengetik prompt di terminal agen tetapi tidak terjadi apa-apa — tidak ada spinner, tidak ada respons, tidak ada konfirmasi.

Penyebab yang paling umum adalah antarmuka agen sedang berada di sub-mode yang tidak membaca input Anda. Misalnya, jika agen membuka file di editor teks seperti vim atau nano di dalam terminal, tombol yang Anda tekan akan masuk ke editor tersebut, bukan ke agen.

Solusi:

  • Tekan Ctrl+C sekali atau dua kali untuk membatalkan apa pun yang sedang dikerjakan agen dan mengembalikannya ke prompt utama. Lalu ketik ulang pesan Anda.
  • Gunakan Agent Input Overlay alih-alih mengetik langsung di terminal. Tekan Cmd+I (atau Ctrl+I di Windows/Linux) untuk membuka kotak input khusus yang mengirim prompt Anda ke agen dengan bersih, melewati masalah kondisi terminal apa pun.
  • Jika agen tampak benar-benar macet, klik kanan tab terminal lalu pilih Restart Terminal untuk memulai sesi agen baru.

Scrollback Terpotong Setelah Respons Agen

Gejala: setelah agen menghasilkan respons yang panjang, Anda menggulir ke atas tetapi hanya bisa mundur sampai jarak tertentu. Output sebelumnya hilang.

Solusi:

  • Klik tombol Expand scrollback di header terminal (ikon panah di kanan atas panel terminal). Ini memuat lebih banyak riwayat ke tampilan secara sementara.
  • Untuk solusi permanen, naikkan batas scrollback: buka Settings → Terminal → Scrollback Lines. Nilai default-nya 10.000 baris. Anda dapat menaikkannya hingga 100.000. Perlu diingat bahwa buffer scrollback yang sangat besar menggunakan lebih banyak memori.

Scrollback Menampilkan Teks Acak atau Tumpang Tindih

Gejala: setelah mengubah ukuran pane atau membuka kembali terminal, riwayat lama menampilkan baris yang menyatu, karakter nyasar, atau blok yang terduplikasi.

Solusi: cari pill berwarna amber Repair view pada terminal. Pill ini muncul ketika sebagian riwayat digambar dengan lebar yang berbeda dari lebar pane saat ini. Klik pill tersebut dan tampilan akan dibangun ulang dari baris terminal itu sendiri yang akurat terhadap lebarnya.


Terminal Menampilkan Pesan “[detached]”

Anda mungkin melihat baris seperti [detached (from session main)] muncul di bagian atas terminal. Ini adalah pesan dari tmux, terminal multiplexer yang digunakan 1DevTool untuk menjaga sesi tetap hidup di latar belakang.

Artinya tampilan sempat terputus dari sesi yang sedang berjalan lalu tersambung kembali. Ini sepenuhnya normal — biasanya terjadi saat Anda berpindah proyek, menyembunyikan dan membuka kembali terminal, atau aplikasi dipulihkan dari kondisi diminimalkan. Sesi Anda dan semua proses yang berjalan tidak terpengaruh.


Terminal Tersembunyi Memulai Sesi Baru, Bukan Melanjutkan

Gejala: Anda menyembunyikan terminal dengan mengklik di tempat lain atau menutup panel, lalu membukanya kembali, dan terminal dimulai dari awal — perintah sebelumnya dan proses yang berjalan sudah hilang.

Penyebab: 1DevTool menggunakan tmux untuk menjaga sesi terminal tetap hidup di latar belakang. Jika tmux tidak terinstal atau tidak ada di PATH shell Anda, sesi tidak dapat dipertahankan dan dimulai dari awal setiap kali.

Solusi: instal tmux lalu mulai ulang 1DevTool.

  • macOS: brew install tmux
  • Linux (Debian/Ubuntu): sudo apt install tmux
  • Linux (Fedora/RHEL): sudo dnf install tmux

Setelah menginstal, keluar dari 1DevTool sepenuhnya lalu luncurkan kembali. Sesi terminal baru kini akan tetap bertahan saat disembunyikan.


Penggunaan CPU Tinggi dari Terminal

Jika mesin Anda terasa panas atau kipasnya berputar keras, mungkin ada proses terminal yang menggunakan CPU secara berlebihan.

Untuk mengidentifikasi sumbernya: arahkan kursor ke setiap tab terminal. Tab yang aktif akan menampilkan indikator berputar. Anda juga dapat membuka terminal dan menjalankan top atau htop untuk melihat proses mana yang bertanggung jawab.

Untuk menghentikannya:

  • Tekan Ctrl+C di terminal untuk menghentikan proses yang sedang berjalan.
  • Atau klik kanan tab terminal lalu pilih Kill Process untuk menghentikan paksa apa pun yang berjalan di dalamnya.

Jika prosesnya adalah dev server atau build tool yang lepas kendali, aman untuk menghentikannya dan memulai ulang dengan perintah start biasa Anda.