Skip to content

Catatan open source

Semua tulisan
01 Nov 20268 menit bacaopen source · Git · code review · developer tools · AI agents · CLIBaca dalam:ENID

Stage CLI: Ubah Git Diff yang Berantakan Menjadi Bab Cerita yang Rapi

Stage CLI mengelompokkan perubahan kode lokal menjadi chapter logis dengan prolog dan konteks risiko, jadi kamu me-review cerita, bukan dinding diff, semuanya lokal.

Editor kode mode gelap menampilkan kode HTML, dengan menu Terminal terlihat di atas.

Agen coding AI menulis kode lebih cepat daripada manusia bisa me-review-nya. Itulah bottleneck yang coba diatasi Stage. Stage CLI adalah tool open source dari ReviewStage yang mengelompokkan perubahan kode lokalmu menjadi chapter logis, menambahkan prolog dan konteks risiko, lalu membuka UI browser tempat kamu me-review cerita dari sebuah perubahan, file demi file, bukan menggulir satu diff raksasa. Tool ini berjalan sepenuhnya di mesinmu dan, seperti tertulis di README-nya, tidak mengunggah source code kamu.

Poin Penting

Stage CLI mengelompokkan perubahan lokal menjadi chapter logis dengan prolog dan konteks risiko, jadi review terasa seperti membaca cerita, bukan dinding diff.

Tool ini berjalan lokal dan membuka UI review di browser. README-nya menyatakan ia tidak mengunggah source code kamu.

Instal dengan npm install -g stagereview, tambahkan skill agen dengan npx skills add ReviewStage/stage-cli, lalu jalankan /stage-chapters di agen AI kamu.

Kamu bisa membatasi cakupan review dengan flag untuk base ref, compare ref, perubahan staged atau unstaged, atau pull request GitHub lewat nomor atau URL.

Komentar yang ditinggalkan di UI bisa diserahkan kembali ke agen coding lewat /stage-resolve, yang akan memperbaiki atau menjawabnya lalu menandai thread tersebut selesai.

Saat artikel ini ditulis, proyek ini punya 275 star, 30 fork, dan 92 commit di GitHub, berlisensi MIT, dan dibuat pada 2026-04-26.

Para pendirinya mengklaim review jadi 5 kali lebih cepat dengan Stage, tapi itu klaim pendiri dari post peluncuran mereka, bukan hasil pengukuran independen.

Tonton sinyal repo 30 detiknya

Sebenarnya Stage Itu Apa

Stage, dari ReviewStage, mendeskripsikan dirinya sebagai "viewer untuk me-review perubahan kode lokal dalam chapter kecil yang individual" yang "bekerja dengan agen AI apa pun". Sederhananya, ini adalah command line tool plus UI browser lokal, bukan layanan review hosted dan bukan bot review. Kamu menjalankannya pada working tree milikmu sendiri, dan ia mengelompokkan perubahan yang berkaitan menjadi chapter, menjelaskan apa yang perlu dilihat sebelum kamu menyelami kode, lalu memberimu permukaan review file demi file dengan komentar inline.

Perbedaan ini penting. Tool seperti CodeRabbit dan Greptile me-review pull request untukmu, secara otomatis. Stage mengambil posisi berlawanan, yang dijelaskan para pendirinya di post Show HN mereka: ia memandumu membaca perubahan selangkah demi selangkah, bukan menggantikan reviewer manusia. Agen tetap terlibat, tapi dengan syaratmu. Kamu yang me-review, kamu yang meninggalkan komentar, dan baru setelah itu agen bertindak atas komentar tersebut.

Proyek ini masih muda. Ia dibuat pada 2026-04-26, dan saat artikel ini ditulis punya 275 star, 30 fork, 92 commit, dan 5 open issue, tanpa release sama sekali. Angka-angka itu menggambarkan proyek tahap awal dengan traksi nyata, bukan standar yang sudah mapan, dan itulah kerangka yang tepat untuk menilainya. Proyek ini juga merupakan perusahaan Y Combinator batch Spring 2026, yang diluncurkan ke publik pada 2026-05-20 menurut post peluncuran Y Combinator mereka.

Kenapa Me-review Diff Terasa Melelahkan

Diff adalah format baca yang buruk. Ia menunjukkan apa yang berubah, baris demi baris, dalam urutan file, tanpa rasa tentang kenapa perubahan-perubahan itu saling berkaitan. Ketika sebuah perubahan menyentuh sepuluh file, diff mencampur refactor, perbaikan bug, dan update test, dan reviewer harus merekonstruksi maksud penulisnya dari potongan-potongan. Ketika agen AI yang menulis perubahan itu, masalahnya memburuk, karena agen tidak lelah, tidak berhenti pada ukuran yang wajar, dan tidak menjelaskan dirinya sendiri kecuali diminta.

Jawaban Stage adalah struktur narasi. Alih-alih satu diff datar, ia menghasilkan chapter, masing-masing mencakup satu bagian logis dari perubahan, plus prolog yang membuka cerita dan konteks risiko yang menandai apa yang pantas mendapat perhatian ekstra. Kamu tetap melihat setiap baris, tapi dalam urutan yang sesuai dengan cara perubahan itu dimaksudkan untuk dipahami. UI-nya mendukung pratinjau file lengkap, image diff, syntax theme, pengaturan tipografi, review chapter berkelanjutan, dan navigasi keyboard, jadi pengalaman membacanya lebih mirip membaca dokumen daripada menggulir terminal.

Ada manfaat kedua yang lebih diam-diam. Karena Stage berjalan lokal, me-review pekerjaan yang masih setengah jadi tidak mengharuskanmu push branch, membuka pull request, atau menunggu tool hosted. Kamu bisa me-review pekerjaan yang belum selesai, termasuk file untracked, sebelum apa pun meninggalkan mesinmu.

Cara Kerja Chapter

Alur kerjanya punya tiga langkah. Instal tool-nya, tambahkan skill ke agenmu, dan jalankan satu perintah.

Langkah

Yang kamu jalankan

Instal

npm install -g stagereview

Tambah skill

npx skills add ReviewStage/stage-cli

Review

/stage-chapters di agen AI kamu

Syaratnya ringan: Node.js 20 atau lebih baru, repositori Git untuk di-review, dan agen AI yang mendukung skill. Kalau kamu ingin me-review pull request GitHub, kamu juga perlu GitHub CLI, gh, yang sudah terinstal dan terautentikasi.

Begitu berjalan, Stage mengelompokkan perubahanmu menjadi chapter dan membuka UI review di browser. Semuanya terjadi di mesinmu. Permukaan review inilah tempat tool ini membuktikan nilainya.

Fitur

Yang kamu dapatkan

Chapter

Perubahan yang berkaitan dikelompokkan menjadi bagian yang logis dan bisa di-review

Prolog

Gambaran awal yang menyiapkan cerita perubahan sebelum kamu membaca kode

Konteks risiko

Penanda tentang apa yang pantas diperhatikan sebelum kamu menyelami kode

Review file demi file

Jalur terpandu melewati perubahan, satu file dalam satu waktu

Komentar inline

Tinggalkan catatan langsung pada diff di browser

Pratinjau file lengkap

Lihat seluruh file, bukan hanya baris yang berubah

Image diff

Perbandingan visual untuk gambar yang berubah

Navigasi keyboard

Berpindah antar chapter dan file tanpa mouse

Dua detail menunjukkan tool ini dibuat oleh orang yang sering me-review kode. Pertama, file .stageignore, yang memakai pola gaya gitignore, mengecualikan file dari analisis diff, tapi file yang diabaikan tetap muncul di chapter "Other changes", jadi tidak ada yang disembunyikan diam-diam. Kedua, file .stageinstructions di root repositori memberi panduan review yang persisten, seperti konvensi proyek atau area yang pantas mendapat perhatian ekstra, dan flag --instructions sekali pakai (maksimal 1000 karakter) mencakup satu run saja.

Membatasi Cakupan Review Dengan Flag

Tool review hanya berguna kalau kamu bisa mengarahkannya tepat ke perubahan yang kamu maksud. Flag Stage mencakup kasus-kasus yang muncul dalam pekerjaan sehari-hari.

Flag

Fungsinya

--base

Base ref untuk dibandingkan, otomatis mendeteksi main atau master

--compare

Compare ref untuk dibandingkan dengan base ref

--ref

Cakupan diff: work (staged plus unstaged plus untracked), staged, atau unstaged

--pr

Me-review pull request GitHub lewat nomor atau URL, membutuhkan gh

--instructions

Instruksi sekali pakai untuk pembuatan chapter, maksimal 1000 karakter

Dalam praktiknya, itu berarti kamu bisa me-review hanya perubahan staged dengan /stage-chapters --ref staged, membandingkan dengan branch tertentu lewat /stage-chapters --base feature-a, membandingkan dua branch dengan /stage-chapters main feature, atau me-review pull request rekan setim dengan /stage-chapters --pr 123, tanpa checkout branch mereka. Untuk pull request, Stage memuat perubahan itu dan menampilkan timeline review, komentar, label, status file yang sudah dilihat, status merge, dan navigasi stacked pull request bila tersedia, sementara aksi seperti mengirim komentar atau merge tetap tunduk pada izin GitHub kamu.

Dari Komentar Menjadi Perbaikan, Tanpa Meninggalkan Review

Me-review baru setengah dari putaran kerja. Setengah lainnya adalah membuat perbaikan terjadi, dan Stage menutup putaran itu dengan skill kedua. Tinggalkan komentar pada diff di UI Stage, lalu serahkan kepada agen coding kamu dengan /stage-resolve. Agen membaca setiap thread yang masih terbuka, membuat perubahan yang diminta atau menjawab pertanyaan, lalu menyelesaikan thread itu dengan ringkasan singkat. Balasannya muncul di browser secara otomatis dengan badge "Agent". Sertakan ref atau flag --pr yang sama seperti saat review, supaya agen melihat diff yang sama.

Di balik layar, ini memakai perintah stagereview comments, yang bekerja tanpa server review berjalan: menampilkan daftar thread terbuka, menampilkan satu thread secara lengkap, membalas, menyelesaikan, membuka kembali, atau membuat komentar pada file dan rentang baris tertentu. Itu pilihan desain yang praktis. UI review untuk membaca, agen untuk bertindak, dan thread komentar adalah kontrak di antara keduanya. Kamu tidak perlu menyalin komentar ke jendela chat atau menjelaskan ulang baris mana yang kamu maksud.

Stage Versi Hosted, dan Berapa Biaya CLI-nya

Stage CLI adalah bagian open source dari produk yang lebih besar. Platform Stage lengkap, di stagereview.app, mengubah setiap pull request menjadi cerita yang bisa diikuti, dengan ide chapter yang sama diterapkan pada review hosted. Halaman harganya mencantumkan paket Starter yang gratis untuk proyek open source dan publik dengan repositori publik tanpa batas, paket Team seharga 30 dolar per pengguna per bulan untuk repositori privat, dan paket Enterprise kustom. FAQ-nya menyatakan Stage sepenuhnya gratis untuk repositori open source tanpa batas waktu.

CLI-nya sendiri berlisensi MIT dan gratis, dan desain local-first-nya berarti harga hosted tidak membatasi alur kerja inti. Kalau kamu hanya me-review perubahan lokal, kamu tidak membayar apa pun dan tidak mengirim apa pun ke mana pun. Produk hosted menjadi relevan kalau timmu menginginkan format cerita yang sama pada pull request, dengan timeline dan komentar bersama, bukan hanya pada diff lokal.

Siapa yang Sebaiknya Mencoba, dan Siapa yang Sebaiknya Menunggu

Stage CLI paling masuk akal kalau kamu sudah me-review kode hasil AI, atau perubahan besar, dan merasakan sakitnya diff datar. Kalau agenmu rutin menghasilkan perubahan multi-file, kalau kamu me-review sebelum push bukan setelah membuka pull request, atau kalau kamu ingin manusia tetap memegang kendali review sambil tetap membiarkan agen melakukan perbaikan, format chapter adalah peningkatan nyata dibanding menggulir diff. Desain local-first juga cocok kalau kamu berhati-hati soal ke mana source code kamu pergi.

Kamu mungkin sebaiknya menunggu, atau menjaga ekspektasi tetap rendah, kalau kamu menginginkan reviewer yang sepenuhnya otomatis, kalau timmu bergantung pada alur review hosted dengan approval dan merge queue, atau kalau kamu membutuhkan tool matang dengan release dan rekam jejak panjang. Stage CLI belum punya release, 275 star-nya mencerminkan adopsi awal, dan klaim kecepatan headline-nya berasal dari para pendirinya, bukan benchmark independen. Cobalah pada satu perubahan nyata, bandingkan review chapter dengan cara menggulir diff biasamu, dan nilailah dari apakah kamu menemukan sesuatu yang seharusnya terlewat.

Kalau kamu bekerja di dunia coding AI yang sama, situs ini punya spotlight terkait tentang tool yang melacak tepat baris mana yang ditulis agen AI kamu: Git AI: Lacak Tepat Baris Mana yang Ditulis Agen Coding AI Anda. Stage CLI membantumu me-review apa yang diubah agen, dan Git AI membantumu membuktikan baris mana yang ditulis agen sejak awal.

Pertanyaan yang Sering Diajukan

Apakah Stage CLI adalah bot code review?

Bukan. Ia mengelompokkan perubahan menjadi chapter dan memandumu membacanya. Ia tidak menyetujui, menolak, atau memperbaiki kode secara otomatis. Agen hanya bertindak atas komentar yang kamu tinggalkan, lewat /stage-resolve.

Apakah Stage mengunggah source code saya?

Tidak. README-nya menyatakan Stage berjalan lokal dan tidak mengunggah source code kamu. UI review terbuka di browser, tapi semuanya terjadi di mesinmu.

Bagaimana cara menginstalnya?

Jalankan npm install -g stagereview, lalu tambahkan skill dengan npx skills add ReviewStage/stage-cli. Syaratnya Node.js 20 atau lebih baru, repositori Git, dan agen AI yang mendukung skill.

Bisakah saya me-review pull request tanpa checkout branch-nya?

Bisa, dengan GitHub CLI yang sudah terinstal dan terautentikasi. Jalankan /stage-chapters --pr diikuti nomor atau URL pull request, dan Stage akan memuat perubahan itu, timeline-nya, komentar, label, dan status merge-nya.

Apakah Stage gratis?

CLI-nya berlisensi MIT dan gratis. Platform Stage hosted gratis untuk proyek open source dan publik, dengan paket Team seharga 30 dolar per pengguna per bulan untuk repositori privat.

Read this article in English

Tag: open source · Git · code review · developer tools · AI agents · CLI

Semua tulisan