Quickstart

Instal Dropstone, masuk, dan kirim perubahan pertama Anda dalam waktu kurang dari lima menit. Panduan ini membawa Anda dari nol hingga loop agen yang berfungsi.

Di akhir panduan ini, Anda akan memiliki Dropstone yang terinstal, masuk, dan menghasilkan edit nyata di proyek pilihan Anda.

Sebelum memulai

Anda memerlukan:

Terminal atau command prompt
Proyek di disk untuk diarahkan ke Dropstone (bahasa apa pun, ukuran apa pun)
Akun Dropstone, yang dapat Anda buat di dropstone.io

Langkah 1: Instal Dropstone

Pilih jalur instalasi untuk platform Anda.

Homebrew (disarankan):

brew tap blankline-org/dropstone-cli
brew install dropstone

Atau skrip instalasi:

curl -fsSL https://dropstone.io/install | bash

Kedua metode menginstal satu biner dropstone di PATH Anda. Tanpa Node, tanpa dependensi runtime.

Verifikasi instalasi:

dropstone --version

Anda akan melihat nomor versi (rilis saat ini adalah 1.0.8). Biner memperbarui dirinya sendiri di latar belakang, sehingga Anda tetap terbarui tanpa menjalankan ulang penginstal.

Langkah 2: 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 tempel.

Kredensial Anda disimpan di disk setelah masuk pertama kali. Untuk mengganti akun nanti, jalankan /login dari dalam Dropstone.

Langkah 3: Mulai sesi pertama Anda

Anda sekarang melihat layar beranda Dropstone. Tiga hal yang perlu diperhatikan:

Tingkat model Anda saat ini ditampilkan di kanan atas (default: Dropstone Fast)
Kotak input di bagian bawah adalah tempat Anda mengetik
Perintah slash dimulai dengan /. Coba /help untuk melihat semuanya

Ketik prompt bahasa alami apa pun untuk memulai sesi. Tidak ada sintaks khusus yang perlu dipelajari.

Langkah 4: Ajukan pertanyaan pertama Anda

Biarkan Dropstone menjelajahi proyek untuk Anda. Coba salah satu dari ini:

apa yang dilakukan proyek ini?

apa saja titik masuk utama?

jelaskan struktur folder

Dropstone akan membaca file sesuai permintaan dan menjawab dengan kutipan ke kode yang sebenarnya. Anda tidak perlu menempelkan file atau menulis konteks secara manual.

Anda juga dapat bertanya kepada Dropstone tentang dirinya sendiri:

apa yang bisa kamu lakukan di proyek ini?

perintah apa yang kamu izinkan untuk dijalankan?

Langkah 5: Buat perubahan kode pertama Anda

Sekarang jelaskan perubahan kecil. Untuk proyek baru, coba sesuatu yang berisiko rendah:

tambahkan README dengan deskripsi proyek satu paragraf

Untuk proyek yang sudah ada:

tambahkan validasi input ke fungsi yang membuat pengguna

Dropstone akan:

Menemukan file yang relevan
Menampilkan perubahan yang diusulkan sebagai diff
Meminta persetujuan Anda sebelum menulis
Memverifikasi hasil (type check, tes, lint jika tersedia)

Izin:

Dropstone meminta persetujuan pertama kali ingin mengedit file atau menjalankan perintah shell. Setujui sekali, dan operasi yang sama di sesi yang sama berjalan tanpa meminta lagi. Gunakan /permissions untuk melihat atau mencabut apa yang telah Anda izinkan.

Langkah 6: Bekerja dengan git

Dropstone memperlakukan git sebagai alat kelas satu:

file apa saja yang sudah saya ubah?

commit perubahan saya dengan pesan yang deskriptif

buat branch bernama feature/health-endpoint dan pindah ke sana

tampilkan lima commit terakhir

bantu saya menyelesaikan konflik merge di src/auth.ts

Untuk alur kerja tingkat PR (membuka pull request, membuat deskripsi PR, mengirim komentar review), lihat integrasi GitHub.

Langkah 7: Perbaiki bug atau tambahkan fitur

Jelaskan apa yang Anda inginkan dalam bahasa sehari-hari. Dropstone akan menemukan kode, memahami konteks, mengimplementasikan perubahan, dan memverifikasinya.

ada bug di mana kueri pencarian kosong mengembalikan semua hasil - perbaiki

tambahkan endpoint /healthz ke server API yang mengembalikan info build

formulir login crash saat email tidak ada - cari tahu penyebabnya dan perbaiki

Jika tugas mencakup beberapa file, Dropstone akan menulis rencana singkat dan mengeksekusinya langkah demi langkah. Anda dapat menekan Esc kapan saja untuk menginterupsi dan mengarahkan.

Langkah 8: Coba alur kerja umum lainnya

Beberapa pola yang dikuasai Dropstone:

Refactor

refactor modul auth untuk menggunakan async/await alih-alih callback

Menulis tes

tulis unit test untuk fungsi kalkulator

Review kode

review perubahan yang saya stage dan tandai apa pun yang berisiko

Dokumentasi

perbarui instruksi instalasi README untuk menyertakan jalur WSL

Tip:

Bicaralah dengan Dropstone seperti rekan kerja. Jelaskan apa yang ingin Anda capai, bukan langkah persis untuk sampai ke sana. Agen paling baik dalam perencanaan ketika Anda menyerahkan pilihan implementasi kepadanya.

Perintah penting

Beberapa perintah yang benar-benar akan Anda gunakan:

Perintah	Fungsinya	Contoh
`dropstone`	Mulai sesi interaktif di direktori saat ini	`dropstone`
`dropstone run "task"`	Jalankan tugas sekali dan keluar	`dropstone run "jelaskan auth.ts"`
`dropstone -c`	Lanjutkan sesi terakhir di direktori ini	`dropstone -c`
`dropstone --session ID`	Lanjutkan sesi tertentu berdasarkan id	`dropstone --session 7f3a...`
`/help`	Tampilkan semua perintah slash	di dalam sesi
`/effort`	Ganti tingkat model untuk sesi ini	`/effort high`
`/clear`	Bersihkan percakapan saat ini	di dalam sesi
`/login`	Ganti akun	di dalam sesi
`exit` atau `Ctrl+D`	Keluar dari Dropstone

Referensi lengkap ada di halaman CLI dan perintah slash.

Tips pro untuk pengguna baru

Apa selanjutnya

Referensi CLI

Setiap flag, setiap subcommand, setiap opsi. Halaman yang Anda bookmark.

Perintah slash

Setiap perintah slash di satu tempat. Berguna setelah seminggu penggunaan.

Ajari Dropstone repo Anda (AGENTS.md)

Letakkan file di root repo yang memberi tahu Dropstone konvensi, perintah build, dan hal-hal yang perlu diperhatikan.

Hubungkan alat Anda sendiri (MCP)

Hubungkan database, API internal, sistem tiket, atau apa pun yang berbicara Model Context Protocol.

Model & penyedia

Lebih lanjut tentang Fast 1.6, Pro 1.6, dan Heavy 1.6, plus cara mengatur default di konfigurasi Anda.

Izin

Kontrol dengan tepat apa yang dapat dibaca, ditulis, dan dieksekusi Dropstone di proyek Anda.

Mendapatkan bantuan

Di dalam Dropstone, ketik /help atau tanyakan dalam bahasa sehari-hari ("bagaimana cara mengganti model?")
Jelajahi dokumentasi lainnya di docs.dropstone.io
Ajukan masalah atau permintaan fitur di dropstone.io/contact

Overview

Pricing