Ringkasan
Dropstone CLI adalah alat coding 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 coding agen jika Anda hidup 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 menempatkan 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 untuk Anda, 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 coding.
| Tingkat | Terbaik untuk |
|---|---|
| Fast | Edit cepat, scaffolding, refactor file tunggal. Tingkat default. |
| Pro | Refactor multi-file, perubahan lintas-bagian, penalaran yang lebih luas. |
| Heavy | Keputusan arsitektur, migrasi besar, debugging yang ambigu atau berat riset. |
Ganti tingkat selama sesi dengan /effort low, /effort medium, /effort high, atau /effort xhigh. Ctrl+T untuk bersiklus di antara mereka. 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 repo. Commit 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 pencarian fuzzy file dan sematkan 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 suruh ia melanjutkan.
Edit langsung
Untuk perubahan kecil, lewati rencana:
Add auth to /settings the same way it is handled in /notes.
Undo dan redo
/undo
/redo
/undo mengembalikan siklus edit sebelumnya dan menampilkan ulang 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 menginginkan lebih banyak ruang.