Belajar Zellij - Keybindings & Mode System

#Pendahuluan

Semua yang kalian tekan di Zellij — Ctrl+p, Ctrl+t, Ctrl+o, bahkan Alt+n — adalah bagian dari satu sistem yang menyatukan seluruh tools ini: mode system. Di episode 3 kalian sudah menggunakannya tanpa sadar. Episode 4 ini akan membedah konsep tersebut secara utuh, karena pemahaman mode adalah perbedaan paling fundamental antara Zellij dan tmux, dan kunci untuk merasakan Zellij terasa alami dibanding menghafal.

Mari jujur tentang apa yang terjadi ketika pemula memakai tmux: mereka mengingat "Ctrl+b lalu c untuk window baru", "Ctrl+b lalu % untuk split", dan "Ctrl+b lalu d untuk detach". Ketika lupa, tidak ada petunjuk — harus membuka man tmux atau bergantung pada cheat sheet. Zellij merancang ulang model ini dari nol. Alih-alih satu prefix yang dibebani semua aksi, Zellij mengelompokkan aksi ke dalam mode, dan setiap mode menampilkan petunjuknya sendiri di layar.

Di episode ini kita akan membahas perbedaan mode-based keybinding dengan prefix key, peta lengkap semua mode (Ctrl+p, Ctrl+t, Ctrl+n, Ctrl+h, Ctrl+s, Ctrl+o, Ctrl+g, Ctrl+q), peran Esc dan Enter sebagai jalan kembali ke Normal mode, quick keys Alt+ yang bekerja langsung, serta Tmux mode (Ctrl+b) untuk kalian yang pindah dari tmux. Mari mulai.

#Mode-Based vs Prefix Key

Untuk memahami mengapa Zellij memilih mode, kita harus jujur tentang masalah yang dibawa model prefix key tmux. Di tmux, setiap aksi adalah rangkaian prefix + tombol: Ctrl+b diikuti % untuk split, Ctrl+b diikuti n untuk window berikutnya, dan seterusnya. Model ini sederhana untuk dipelajari, tetapi bermasalah dalam skala besar.

Masalah pertama adalah tidak ada petunjuk. Ketika kalian menekan Ctrl+b di tmux, layar tidak menunjukkan apa pun. Kalian harus mengingat kombinasi yang tepat, atau membuka dokumentasi. Zellij menghilangkan masalah ini: menekan Ctrl+p langsung mengganti status bar menjadi petunjuk interaktif yang menampilkan semua aksi pane beserta tombolnya. Lupa cara resize? Tekan Ctrl+n dan baca layar — tidak perlu menghafal.

Masalah kedua adalah satu prefix untuk semua domain. Ctrl+b mengelola window, pane, detach, session, dan ratusan aksi lain — semuanya berebut satu namespace. Akibatnya muncul kombinasi yang tidak intuitif (kenapa split vertikal memakai %?) dan konflik dengan keybinding aplikasi. Zellij memecah namespace ini menjadi mode per domain: urusan pane di Pane mode, urusan tab di Tab mode, urusan session di Session mode. Setiap domain punya ruang tombolnya sendiri yang lapang.

Masalah ketiga adalah konteks yang tidak bisa dibedakan. Di tmux, prefix yang sama dipakai untuk aksi yang berbeda tergantung apakah kalian di session atau tidak. Zellij mengatasi ini dengan Locked mode dan mode yang eksplisit: ketika kalian berada di Scroll mode, tombol berarti aksi scroll; di Pane mode, tombol berarti aksi pane. Kalian selalu tahu sedang berada di mode apa — status bar menampilkannya terus-menerus.

Aspek	tmux (prefix)	Zellij (mode)
Petunjuk di layar	Tidak ada	Selalu tampil di status bar
Organisasi aksi	Satu prefix untuk semua	Mode per domain
Belajar	Menghafal kombinasi	Membaca petunjuk
Konflik editor	Sering terjadi	Dikelola per mode
Konteks	Tergantung session	Eksplisit di status bar

Inilah inti filosofi Zellij: interaksi tidak harus dihafal; ia harus bisa dibaca. Kalian tetap akan menghafal keybinding yang sering dipakai seiring waktu, tetapi itu terjadi secara alami, bukan sebagai prasyarat.

#Peta Mode Lengkap

Zellij memiliki delapan mode pemicu utama yang diakses lewat Ctrl+ kombinasi, ditambah mode khusus yang dijelaskan di bagian tersendiri. Berikut peta lengkapnya:

Mode	Pemicu	Domain Aksi
Normal	-	Quick keys `Alt+...`, semua mode kembali ke sini
Pane	`Ctrl+p`	Membuat, menutup, dan mengelola pane
Tab	`Ctrl+t`	Membuat, berpindah, dan mengelola tab
Resize	`Ctrl+n`	Mengubah ukuran pane
Move	`Ctrl+h`	Memindahkan posisi pane
Scroll	`Ctrl+s`	Menjelajahi scrollback dan mencari
Session	`Ctrl+o`	Mengelola session, detach, rename
Locked	`Ctrl+g`	Mengunci seluruh input
Tmux	`Ctrl+b`	Emulasi keybinding umum tmux

Perhatikan pola yang konsisten: setiap domain kerja besar punya pemicu yang mudah ditekan dan bersebelahan di keyboard. Ctrl+p (Pane), Ctrl+t (Tab), Ctrl+s (Scroll), Ctrl+o (Session) — semuanya mengelompok di area kiri bawah keyboard, mudah dijangkau tanpa melepas posisi tangan.

Pane mode (Ctrl+p) adalah mode yang paling sering dipakai. Di sini kalian membuat pane (n), split (d/r), menutup (x), memindahkan fokus (h/j/k/l), zoom (f), dan mengelola floating panes (w). Tab mode (Ctrl+t) menangani pembuatan tab (n), navigasi (h/l), rename (r), dan penutupan (x). Session mode (Ctrl+o) berisi aksi level tertinggi: detach (d), rename session (r), dan kembali ke daftar session (s).

Note

Ada dua mode yang mudah tertukar karena tombolnya mirip: Resize (Ctrl+n) dan Move (Ctrl+h). Resize mengubah ukuran pane — pane yang lebih kecil di sisi satu, lebih besar di sisi lain. Move mengubah posisi pane dalam layout — pane berpindah tempat, ukurannya tetap. Di kedua mode ini, arah ditentukan dengan tombol panah atau h/j/k/l.

Scroll mode (Ctrl+s) mengalihkan pane aktif dari input langsung ke penjelajahan history. Tekan j/k untuk bergerak baris demi baris, Ctrl+f/Ctrl+b untuk satu halaman, dan g/G untuk lompat ke awal/akhir. Dari Scroll mode kalian bisa masuk ke Search mode dengan Ctrl+f dan mulai mengetik pola pencarian — kemampuan yang akan kita bedah penuh di episode 6. Locked mode (Ctrl+g) adalah saklar darurat yang memblokir semua input agar tidak ada keystroke yang bocor ke shell secara tidak sengaja — sering dipakai saat presentasi atau ketika laptop ditinggal sejenak.

#Esc & Enter: Kembali ke Normal Mode

Setiap mode memiliki jalan keluar yang konsisten: Esc atau Enter selalu mengembalikan kalian ke Normal mode. Konsistensi inilah yang membuat mode terasa aman — tidak peduli sejauh apa kalian menjelajah, ada tombol universal untuk kembali ke pangkal.

Normal mode adalah pusat gravitasi Zellij. Dari sini kalian masuk ke mode apa pun (Ctrl+p, Ctrl+t, Ctrl+o, dan seterusnya), dan ke sini semua mode kembali. Di Normal mode, quick keys Alt+... aktif, dan tidak ada keybinding yang mengganggu pengetikan biasa — kalian bisa mengetik perintah shell dengan bebas karena Normal mode tidak menangkap keystroke.

Kebiasaan yang perlu ditanam sejak awal: jika merasa "macet" di dalam mode, tekan Esc beberapa kali. Kebanyakan perasaan macet di Zellij sebenarnya adalah kalian masih berada di dalam mode yang tidak disadari, dan Esc selalu menyelesaikan masalah ini. Status bar menampilkan mode aktif di pojok — biasakan membaca pojok itu sebelum menekan tombol.

Selain Esc/Enter, Zellij menyediakan jalan pintas penemuan yang sangat berguna: tekan ? di dalam mode mana pun untuk menampilkan daftar lengkap keybinding mode tersebut. Alih-alih membuka dokumentasi setiap kali bingung, tekan ? dan baca petunjuk yang langsung tampil. Ini adalah contoh nyata filosofi "bisa dibaca, bukan dihafal".

Tip

Latih refleks ini dalam lima menit: masuk ke Pane mode (Ctrl+p), tekan ? untuk melihat daftar aksi, lalu Esc untuk kembali. Lakukan hal yang sama untuk Tab mode (Ctrl+t) dan Session mode (Ctrl+o). Setelah beberapa kali, kalian tidak akan pernah takut "tersesat" di dalam Zellij lagi — jalan keluarnya selalu Esc, dan petunjuknya selalu ?.

#Quick Keys Normal Mode

Mode Ctrl+... memang lengkap, tetapi untuk aksi yang paling sering, masuk mode setiap kali terasa lambat. Zellij menjawabnya dengan quick keys: kombinasi Alt+... yang bekerja langsung di Normal mode, tanpa perlu masuk mode terlebih dahulu.

Quick Key	Aksi
`Alt+h` / `Alt+j` / `Alt+k` / `Alt+l`	Memindahkan fokus ke pane sesuai arah
`Alt+n`	Membuat pane baru
`Alt+f`	Toggle floating panes
`Alt+=`	Memperbesar pane aktif
`Alt+-`	Memperkecil pane aktif
`Alt+[`	Swap layout ke kiri
`Alt+]`	Swap layout ke kanan

Empat quick key yang paling menentukan kecepatan harian adalah Alt+h/j/k/l untuk memindahkan fokus antar pane. Setelah kalian terbiasa, tangan tidak perlu berpindah dari baris tombol: Alt+l untuk pindah ke pane kanan, Alt+n untuk membuka pane baru, Alt+- untuk memberi lebih banyak ruang, dan seterusnya. Quick keys inilah yang membuat Zellij terasa "mengalir" dibandingkan berpindah mode untuk setiap aksi kecil.

Alt+f menoggle floating panes: membuatnya muncul di atas konten atau menyembunyikannya kembali. Alt+[ dan Alt+] menggeser layout antar varian yang sudah didefinisikan — kalian akan merasakan manfaatnya lebih dalam di episode 7 saat membahas swap layout. Yang penting untuk sekarang: quick keys adalah lapisan akselerasi di atas mode, bukan penggantinya. Mode tetap ada sebagai fallback yang lengkap dan selalu bisa dibaca.

#Tmux Mode untuk Para Migran

Zellij menyadari bahwa banyak pengguna datang dari tmux dengan muscle memory yang sudah terlatih bertahun-tahun. Memaksa mereka menghafal ulang semuanya dari nol adalah pemborosan. Solusinya adalah Tmux mode: sebuah mode khusus yang diaktifkan dengan Ctrl+b dan mengemulasikan keybinding umum tmux.

Ketika kalian menekan Ctrl+b lalu %, Zellij melakukan split ke kanan — persis seperti tmux. Ctrl+b lalu " untuk split ke bawah, Ctrl+b lalu x untuk menutup pane, Ctrl+b lalu c untuk membuat tab baru, dan Ctrl+b lalu panah untuk memindahkan fokus. Bagi kalian yang baru pindah, Tmux mode menjadi jembatan: terus bekerja dengan kebiasaan lama sambil perlahan beralih ke mode Zellij yang lebih kaya.

Tmux Mode (`Ctrl+b` lalu)	Aksi
`%`	Split ke kanan
`"`	Split ke bawah
`x`	Menutup pane
`c`	Membuat tab baru
panah / `h`/`j`/`k`/`l`	Memindahkan fokus pane
`d`	Detach

Important

Tmux mode adalah subset kurasi, bukan emulasi penuh tmux. Tidak semua keybinding tmux tersedia, dan beberapa perilaku (seperti session yang tersembunyi di balik perintah tmux yang disuntikkan) tidak mungkin ditiru. Gunakan Tmux mode sebagai jembatan migrasi — bukan sebagai alasan untuk tidak mempelajari mode system Zellij. Sebagian besar pengguna menemukan mode Zellij lebih nyaman setelah beberapa minggu, dan Tmux mode bisa dinonaktifkan di konfigurasi.

Tmux mode juga menegaskan satu hal penting: mode system Zellij bersifat data, bukan kodrat. Definisi mode, keybinding di dalamnya, bahkan kehadiran Tmux mode sendiri, semuanya hidup di file konfigurasi KDL dan bisa diubah sepenuhnya. Di episode 8 dan 9 kalian akan membuka file itu dan melihat bagaimana seluruh peta mode yang kita bahas di episode ini hanyalah satu set konfigurasi default yang bisa kalian kendalikan penuh.

Sebagai perbandingan terakhir, berikut bagaimana aksi yang sama dilakukan lewat CLI — membuktikan bahwa apa yang kalian lihat di layar juga bisa dikendalikan dari luar, fondasi untuk otomasi di episode 13:

tmux split-window -v

zellij action new-pane mengirim perintah ke session aktif persis seperti menekan keybinding — hanya saja kali ini bisa dijalankan dari script. Inilah kekuatan mode yang dibangun di atas protokol yang jelas: interaksi keyboard dan interaksi program menggunakan jalur yang sama.

#Kesalahan Umum (Common Pitfalls)

Menekan Ctrl+ kombinasi lalu langsung menekan aksi tanpa jeda. Mode Zellij menunggu aksi berikutnya; jika kalian menekan Ctrl+p lalu segera n tanpa melepas Ctrl, kombinasi bisa tertangkap sebagai karakter lain. Tekan Ctrl+p, lepas, lalu tekan n.
Lupa bahwa Esc dan Enter selalu kembali ke Normal mode. Ketika merasa keybinding tidak merespons, cek status bar dan tekan Esc — hampir selalu solusinya.
Mengira Tmux mode emulasi penuh tmux. Keybinding di luar subset kurasi tidak tersedia. Jangan menjadikan Tmux mode sebagai penghambat untuk belajar mode system Zellij yang sebenarnya.
Mencampur Resize dan Move. Ctrl+n mengubah ukuran; Ctrl+h memindahkan posisi. Kebalikannya adalah dua pengalaman yang membingungkan, jadi pastikan mode yang benar sebelum menekan panah.
Menghafal semua keybinding sekaligus. Ini jalan pintas menuju frustrasi. Hafal tiga dulu (Ctrl+p, Ctrl+t, Alt+h/j/k/l), biarkan ? menolong kalian di sela-sela, dan sisanya akan menempel sendiri seiring penggunaan.

#Penutup

Episode 4 ini adalah kunci yang membuka seluruh kekuatan Zellij. Kalian telah memahami mengapa mode-based keybinding mengalahkan prefix key tmux — petunjuk selalu tampil, aksi terorganisasi per domain, dan konflik editor dikelola secara eksplisit. Kalian menguasai peta lengkap mode: Ctrl+p Pane, Ctrl+t Tab, Ctrl+n Resize, Ctrl+h Move, Ctrl+s Scroll, Ctrl+o Session, Ctrl+g Locked, dan Ctrl+q Quit. Kalian tahu bahwa Esc dan Enter adalah jalan universal kembali ke Normal mode, quick keys Alt+... mempercepat aksi sehari-hari, dan Tmux mode (Ctrl+b) menjembatani kedatangan dari tmux.

Poin yang harus kalian bawa:

Mode mengubah interaksi dari hafalan menjadi bacaan — petunjuk selalu ada di status bar.
Setiap domain kerja besar punya mode sendiri; tidak ada prefix tunggal yang membebani segalanya.
Esc dan Enter selalu kembali ke Normal mode; ? menampilkan keybinding mode aktif.
Quick keys Alt+h/j/k/l, Alt+n, Alt+f, Alt+=/Alt+-, Alt+[/Alt+] bekerja langsung tanpa masuk mode.
Tmux mode (Ctrl+b) adalah jembatan migrasi yang menyediakan subset keybinding tmux.
Mode adalah data yang bisa dikonfigurasi ulang sepenuhnya — bukan perilaku yang terkunci.

Sekarang mode system sudah menjadi milik kalian. Fondasi operasional dari episode 3 dan mode dari episode 4 akan menjadi bahasa yang dipakai di seluruh series ini. Di episode 5 kita mendalami pane management lanjutan: resize, fokus, zoom, close yang efisien, toggle pane frames, serta konsep pinned dan stacked pane yang membawa workflow bertingkat. Sampai jumpa di episode 5!