Ringkasan
Dropstone CLI adalah alat pengkodean agen yang berjalan di terminal Anda. Minta ia membaca kode, menjalankan perintah, merencanakan perubahan, dan mengedit file, semuanya dari shell Anda.
Dropstone adalah jalur tercepat menuju pengkodean agen jika Anda tinggal di terminal. Halaman ini membantu Anda terinstal, masuk, dan memulai percakapan pertama Anda.
Prasyarat
- Emulator terminal modern. Apa pun bisa; kami menguji dengan WezTerm, Alacritty, Ghostty, dan Kitty.
- Akun Dropstone. Daftar di dropstone.io untuk menggunakan jajaran model bawaan (Fast, Pro, Heavy).
Instalasi
Homebrew (disarankan):
brew tap blankline-org/dropstone-cli
brew install dropstone
Atau skrip instalasi:
curl -fsSL https://dropstone.io/install | bash
Kedua metode menghasilkan satu biner dropstone di PATH Anda. Tanpa Node, tanpa dependensi runtime.
Verifikasi instalasi:
dropstone --version
Masuk
Pindah ke direktori proyek mana pun dan mulai Dropstone:
cd /path/to/your/project
dropstone
Pada peluncuran pertama, Anda akan diminta untuk masuk. Dua opsi:
- Lanjutkan di browser (disarankan). Membuka dropstone.io/login, masuk, dan mengembalikan token ke CLI secara otomatis. Menggunakan PKCE sehingga token tidak pernah muncul di bilah URL browser Anda.
- Tempel token. Untuk sesi SSH atau headless. Dapatkan token di dropstone.io/account dan tempelkan.
Jalankan /login dari dalam Dropstone untuk mengganti akun nanti.
Pilih model
Dropstone menyediakan tiga tingkatan model. Ketiganya dihosting di infrastruktur AS dan disesuaikan untuk pengkodean.
| Tingkat | Terbaik untuk |
|---|---|
| Fast | Edit cepat, pembuatan kerangka, refaktor file tunggal. Tingkat default. |
| Pro | Refaktor multi-file, perubahan lintas-bagian, penalaran yang lebih luas. |
| Heavy | Keputusan arsitektur, migrasi besar, debugging yang ambigu atau berbasis riset. |
Ganti tingkat selama sesi dengan /effort low, /effort medium, /effort high, atau /effort xhigh. Ctrl+T untuk berpindah di antaranya. Lihat Models untuk informasi lebih lanjut.
Inisialisasi proyek
Di dalam root proyek, jalankan:
/init
Dropstone memindai struktur proyek Anda dan membuat file AGENTS.md di root repositori. Komit ke git: di sinilah Anda mengkodekan konvensi proyek, perintah build, dan jebakan yang harus diketahui Dropstone pada setiap prompt.
Lihat Rules (AGENTS.md) untuk format lengkapnya.
Percakapan pertama
Anda siap. Ajukan pertanyaan, minta perubahan, atau rencanakan fitur.
Tanya tentang kode
How is authentication handled in @src/auth/session.ts?
Gunakan @ untuk mencari file secara fuzzy dan menyematkannya ke dalam prompt.
Rencanakan sebelum membangun
Tekan Tab untuk beralih ke Plan mode. Dalam Plan mode, Dropstone tidak dapat mengedit file; ia hanya menjelaskan apa yang akan dilakukannya.
Add a "deleted_at" column to the notes table. Then build a screen that
lists recently deleted notes with restore and permanent-delete buttons.
Iterasi pada rencana. Saat Anda puas, tekan Tab lagi untuk kembali ke Build mode dan beri tahu untuk melanjutkan.
Edit langsung
Untuk perubahan kecil, lewati rencana:
Add auth to /settings the same way it is handled in /notes.
Batalkan dan ulangi
/undo
/redo
/undo mengembalikan siklus edit sebelumnya dan menampilkan kembali prompt Anda sehingga Anda dapat menyesuaikannya. Jalankan beberapa kali untuk mundur lebih jauh. /redo memutar ulang langkah yang dibatalkan.
Penggunaan dan batas
Ketik /usage untuk melihat penggunaan mingguan Anda, tingkat paket, dan hitung mundur reset. Ketik /upgrade untuk membuka halaman harga jika Anda ingin lebih banyak ruang.