Belajar Fzf - Integrasi dengan Editor & Developer Ecosystem

#Pendahuluan

Di episode 19 kalian melihat ke mana fzf berkembang selama seri 0.70-0.74. Episode 20 ini menggeser fokus: bukan lagi fzf berdiri sendiri, melainkan fzf sebagai anggota ekosistem developer. Kalian akan belajar menempatkannya di dalam editor dan menggandengkannya dengan tools yang membentuk alur kerja harian — dari berpindah file, mencari kode, menavigasi direktori, memilih PR, sampai menilik diff.

Bayangkan fzf sebagai jantung yang tidak pernah terlihat: ia tidak tampil dalam daftar fitur editor, tetapi denyutnya terasa di mana-mana — pemilih file, pemilih buffer, pemilih command, semuanya berdetak dengan pola fuzzy. Episode ini membuat detak itu disadari dan dikendalikan, bukan hanya dinikmati.

Episode ini membahas integrasi Neovim (fzf.vim, fzf-lua, telescope.nvim), pola fuzzy di VS Code, lalu empat pendamping penting: zoxide untuk navigasi cerdas, gh CLI untuk repo dan PR, lazygit untuk git yang ramah, dan kombinasi bat dengan delta untuk preview yang hidup.

#Neovim: fzf.vim

fzf lahir dari kebutuhan mencari file di Vim, jadi tak heran integrasi terbaiknya ada di keluarga Vim. fzf.vim adalah plugin resmi dari pembuat fzf yang menambahkan perintah-perintah fuzzy di dalam Neovim. Pemasangannya paling mudah lewat vim-plug:

Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
Plug 'junegunn/fzf.vim'

Setelah terpasang dan di-:source ulang, perintah-perintah kunci langsung tersedia:

Kekuatan fzf.vim ada pada kesederhanaannya: setiap perintah memanfaatkan fzf binary yang sudah terpasang, sehingga perilakunya identik dengan fzf di terminal — termasuk opsi --preview yang bisa diteruskan lewat variabel konfigurasi.

let g:fzf_preview_window = ['up:60%', 'ctrl-/']
command! -bang -nargs=* Rg
  \ call fzf#vim#grep('rg --column --line-number --no-heading --color=always '.shellescape(<q-args>), 1, <bang>0)

#Neovim: fzf-lua

Jika kalian lebih nyaman dengan Lua dan konfigurasi yang eksplisit, fzf-lua adalah pilihan modern. Ia ditulis murni dalam Lua, memakai fzf binary sebagai backend, dan menawarkan banyak preset pemilih — file, buffer, git status, LSP symbols, hingga ripgrep. Konfigurasi dasarnya sangat singkat:

local fzf_lua = require('fzf-lua')
fzf_lua.setup({})
 
vim.keymap.set('n', '<C-p>', function()
  fzf_lua.files()
end, { desc = 'Cari file dengan fzf' })

Keunggulan fzf-lua dibanding fzf.vim: hasil pencarian bisa dikustomisasi per pemilih, memakai fzf sebagai backend sekaligus tetap memanfaatkan previewer.builtin yang mengerti file, git, dan buffer. Ketika kalian membutuhkan "satu pemilih untuk setiap tugas" dengan kontrol halus, fzf-lua adalah kompromi terbaik antara kekuatan fzf dan ergonomi Neovim modern.

#Neovim: telescope.nvim dengan Backend fzf

telescope.nvim adalah pemilih fuzzy paling populer di ekosistem Neovim. Ia tidak menggunakan fzf secara bawaan — scoring fuzzy-nya sendiri — tetapi telescope-fzf-native.nvim mengganti engine scoring-nya dengan implementasi fzf dalam C, memberi hasil yang jauh lebih cepat dan urutan yang lebih konsisten dengan fzf di terminal:

Plug 'nvim-lua/plenary.nvim'
Plug 'nvim-lua/telescope.nvim', { 'tag': '0.1.x' }
Plug 'nvim-telescope/telescope-fzf-native.nvim', { 'do': 'make' }

require('telescope').setup {
  extensions = {
    fzf = { fuzzy = true, override_generic_sorter = true }
  },
}
require('telescope').load_extension('fzf')

Perbedaan konseptualnya penting: di telescope, fzf bukan antarmuka — ia adalah mesin scoring di belakang layar. Antarmukanya tetap milik telescope; yang dipinjam adalah kecepatan dan urutan hasil ala fzf. Bagi kalian yang sudah menguasai fzf di terminal, pengalaman telescope akan terasa familiar karena hasilnya "berpikir" seperti fzf.

#VS Code: Fuzzy di Dalam Editor

VS Code tidak "menjalankan fzf" secara langsung, tetapi filosofi fuzzy-nya sudah tertanam di jantung editor: Quick Open (Ctrl+P) dan Command Palette (Ctrl+Shift+P) adalah pemilih fuzzy bawaan untuk file dan perintah. Extension di marketplace menambah cakupan — pencarian symbol, git branch, dan berbagai preset — dengan pola interaksi yang sama.

Di sisi lain, terminal terintegrasi VS Code bisa menjalankan fzf secara penuh. Ini pola yang sering terlewat: kombinasi rg + fzf di terminal VS Code untuk pekerjaan yang tidak dimiliki Quick Open — misalnya memilih branch lalu checkout, atau memilih file untuk di-diff:

git status --short | fzf --multi --preview 'git diff --color=always {}' |
  awk '{print $2}' | xargs git diff

Pola ini menunjukkan satu prinsip: editor modern punya fuzzy bawaan, tetapi fzf tetap unggul ketika pilihan harus diproses lebih lanjut — dipipakan ke perintah lain, di-preview dengan bat, atau digabung dengan git.

#zoxide: Navigasi Direktori yang Cerdas

Pindah ke pendamping di luar editor. zoxide adalah "smarter cd" — ia merekam direktori yang sering kalian kunjungi (frecency) dan membiarkan kalian lompat dengan sebagian nama. Yang membuatnya relevan dengan series ini: zoxide memiliki integrasi fzf bawaan. Dengan mode --cmd cd, ketika nama yang kalian ketik tidak cocok persis dengan satu direktori, zoxide membuka pemilih interaktif berbasis fzf untuk memilih dari kandidat:

eval "$(zoxide init --cmd cd zsh)"

cd apic
cd fzfproj

Kombinasi zoxide + fzf adalah contoh terbaik fzf sebagai fallback interaktif: zoxide menangani kasus cepat (nama persis), fzf menangani kasus ragu (banyak kandidat). Dua lapisan yang saling melengkapi, bukan bersaing.

#gh CLI: Repo dan PR lewat Fuzzy

gh — GitHub CLI — adalah pendamping berikutnya. Outputnya yang berbentuk tabel adalah bahan mentah sempurna untuk fzf: kolom pertama bisa diambil dengan awk lalu dieksekusi. Memilih repo lalu men-clone:

gh repo list --limit 100 | fzf --preview 'gh repo view {1} --json description -q .description' |
  awk '{print $1}' | xargs gh repo clone

Memilih PR lalu checkout secara langsung:

gh pr list | fzf --preview 'gh pr view {1}' | awk '{print $1}' | xargs gh pr checkout

Pola gh ... | fzf | awk '{print $1}' | xargs gh ... adalah idiom yang bisa diulang untuk hampir semua perintah gh: issues, releases, bahkan actions. Sekali kalian memahaminya, antarmuka fuzzy untuk seluruh GitHub menjadi tinggal mengetik.

#lazygit: Git yang Ramah

lazygit adalah TUI git yang membuat operasi kompleks terasa ringan. Relevansinya dengan series ini: lazygit membawa pengalaman fuzzy finder ke dalam tampilannya sendiri — mencari file yang berubah, branch, atau commit tidak lagi mengetik nama, melainkan menyaring daftar secara interaktif dengan pola yang sama seperti fzf. Di layar status, tekan shortcut fuzzy find untuk langsung melompat ke file, dan dari sana staging, commit, dan push dilakukan dengan tombol tunggal.

Pendekatan lazygit dan fzf berbeda cara tetapi sejalan tujuan: mengurangi jarak antara niat dan eksekusi. fzf adalah blok bangunan di terminal; lazygit adalah aplikasi jadi yang mengadopsi filosofinya. Banyak engineer memakai keduanya — fzf untuk memilih apa pun di shell, lazygit ketika pekerjaan sudah jelas-jelas soal git.

#bat dan delta: Preview yang Hidup

Terakhir, dua pager yang mengubah preview fzf dari teks polos menjadi kode berwarna. bat sudah kalian kenal sejak episode 0 sebagai cat dengan syntax highlighting. delta melengkapi dengan memformat git diff menjadi tampilan yang hidup — warna, nomor baris, dan hunks yang rapi:

git status --short | fzf --multi --preview 'git diff --color=always -- {2} | delta --color-only'

fd -t f | fzf --preview 'bat --color=always --style=numbers {}'

Gabungkan keduanya dengan gh: preview PR yang menampilkan diff berwarna membuat peninjauan code review terasa seperti bekerja di editor, padahal kalian hanya di terminal. bat dan delta adalah dua alasan paling kuat untuk selalu mengutip placeholder — {} yang tidak dikutip akan memecah nama file ber-spasi dan membuat preview tampak error.

#Kesalahan Umum

#Penutup

Pada episode 20 ini kalian membawa fzf ke tengah ekosistem developer: fzf.vim, fzf-lua, dan telescope.nvim dengan backend fzf-native di Neovim; pola fuzzy Quick Open dan terminal terintegrasi di VS Code; zoxide yang menjadikan fzf fallback interaktif untuk navigasi; gh CLI dengan idiom gh ... | fzf | xargs gh ... untuk repo dan PR; lazygit yang mengadopsi filosofi fuzzy dalam TUI git; serta bat dan delta yang menghidupkan preview dengan warna.

Pesan untuk dibawa pulang: fzf adalah lapisan yang menempel di mana pun ada daftar — dan setiap daftar di ekosistem developer adalah kandidat pemilih fuzzy.

Semua integrasi ini, bagaimanapun, akan sia-sia jika konfigurasi hanya hidup di satu mesin. Di episode 21 kita membahas production-ready setup & dotfiles — menyimpan FZF_* dan keybinding di repo dotfiles, konfigurasi konsisten untuk bash/zsh/fish/nushell, bootstrap otomatis di mesin baru, hingga checklist konfigurasi yang deterministik untuk tim.