Troubleshooting: Terminal

Terminal Terbuka tapi Tidak Ada Output Saat Mengetik

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

Penyebab dan perbaikan yang mungkin:

Error file init shell. File startup shell Anda (.zshrc, .bashrc, atau .bash_profile) mungkin memiliki error sintaks atau command yang hang. Buka terminal Bash biasa di 1DevTool dan jalankan:

cat ~/.zshrc

Cari error yang jelas — quote penutup yang hilang, variabel yang tidak terdefinisi, atau command source yang menunjuk ke file yang tidak ada. Perbaiki error di Env Manager atau text editor, lalu buka kembali terminal.

Jenis terminal salah. Jika Anda memilih terminal "Claude Code" tapi CLI claude tidak terinstal, terminal akan terbuka tapi shell akan gagal meluncurkan agent. Instal Claude Code terlebih dahulu (npm install -g @anthropic-ai/claude-code), atau ganti jenis terminal ke session Bash atau Zsh biasa.

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

AI Agent Tidak Merespons Input

Gejala: Anda mengetik prompt di terminal agent tapi tidak ada yang terjadi — tidak ada spinner, tidak ada respons, tidak ada acknowledgement.

Penyebab paling umum adalah interface agent berada di sub-mode di mana ia tidak membaca input Anda. Misalnya, jika agent membuka file di text editor seperti vim atau nano di dalam terminal, keypress masuk ke editor itu alih-alih agent.

Perbaikan:

• Tekan Ctrl+C sekali atau dua kali untuk membatalkan apa pun yang dilakukan agent dan mengembalikannya ke prompt utama. Lalu ketik ulang pesan Anda.
• Gunakan Agent Input Overlay alih-alih mengetik langsung ke terminal. Tekan Cmd+I (atau Ctrl+I di Windows/Linux) untuk membuka input box dedicated yang mengirim prompt Anda dengan bersih ke agent, melewati masalah state terminal apa pun.
• Jika agent terlihat benar-benar beku, klik kanan tab terminal dan pilih Restart Terminal untuk memulai session agent baru.

Scrollback Terpotong Setelah Respons Agent

Gejala: setelah agent menghasilkan respons panjang, Anda scroll ke atas tapi hanya bisa kembali sejauh tertentu. Output sebelumnya telah hilang.

Perbaikan:

• Klik tombol Expand scrollback di header terminal (ikon panah di kanan atas panel terminal). Ini sementara memuat lebih banyak riwayat ke tampilan.
• Untuk perbaikan permanen, tingkatkan batas scrollback: buka Settings → Terminal → Scrollback Lines. Default adalah 10.000 baris. Anda bisa menaikkannya hingga 100.000. Perhatikan bahwa buffer scrollback yang sangat besar menggunakan lebih banyak memori.

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 session tetap hidup di background.

Ini berarti tampilan sempat terputus sementara dari session yang berjalan lalu terhubung kembali. Ini benar-benar normal — biasanya terjadi saat Anda beralih project, menyembunyikan dan membuka kembali terminal, atau aplikasi dipulihkan dari state minimized. Session Anda dan semua process yang berjalan tidak terpengaruh.

Terminal Tersembunyi Memulai Session Baru Alih-alih Resume

Gejala: Anda menyembunyikan terminal dengan mengklik jauh atau menutup panel, lalu membukanya kembali, dan terminal mulai fresh — command sebelumnya dan process yang berjalan hilang.

Penyebab: 1DevTool menggunakan tmux untuk menjaga session terminal tetap hidup di background. Jika tmux tidak terinstal atau tidak ada di PATH shell Anda, session tidak bisa dipersist dan restart dari awal setiap kali.

Perbaikan: instal tmux dan restart 1DevTool.

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

Setelah menginstal, quit 1DevTool sepenuhnya dan luncurkan ulang. Session terminal baru sekarang akan persist saat disembunyikan.

Penggunaan CPU Tinggi dari Terminal

Jika mesin Anda panas atau kipas berputar kencang, process terminal mungkin mengonsumsi CPU berlebihan.

Untuk mengidentifikasi sumber: hover di atas setiap tab terminal. Tab aktif akan menunjukkan indikator berputar. Anda juga bisa membuka terminal dan menjalankan top atau htop untuk melihat process mana yang bertanggung jawab.

Untuk menghentikannya:

• Tekan Ctrl+C di terminal untuk menginterupsi process yang berjalan.
• Atau klik kanan tab terminal dan pilih Kill Process untuk force-terminate apa pun yang berjalan di dalamnya.

Jika process adalah dev server atau build tool yang runaway, aman untuk membunuhnya dan restart dengan command start normal Anda.