CLI

Opsi dan perintah Dropstone CLI.

Dropstone CLI secara default memulai sesi interaktif ketika dijalankan tanpa argumen apa pun.

dropstone

Namun, CLI ini juga menerima perintah sebagaimana didokumentasikan di halaman ini. Ini memungkinkan Anda berinteraksi dengan Dropstone secara terprogram.

dropstone run "Jelaskan bagaimana closure bekerja di JavaScript"

tui

Memulai sesi Dropstone interaktif. Ini adalah default ketika Anda menjalankan dropstone tanpa subperintah; dropstone tui adalah bentuk eksplisitnya.

dropstone [project]

Flag

Flag	Short	Deskripsi
	`-c`	Melanjutkan sesi terakhir
	`-s`	ID sesi untuk dilanjutkan
		Fork sesi saat melanjutkan (gunakan dengan `--continue` atau `--session`)
		Prompt yang akan digunakan
	`-m`	Model yang akan digunakan (`dropstone/dropstone-fast`, `dropstone/dropstone-pro`, atau `dropstone/dropstone-heavy`)
		Agen yang akan digunakan
		Port untuk didengarkan
		Hostname untuk didengarkan
		Aktifkan penemuan mDNS
		Nama domain mDNS kustom
		Origin browser tambahan untuk mengizinkan CORS

Perintah

Dropstone CLI juga memiliki perintah-perintah berikut.

agent

Mengelola agen untuk Dropstone.

dropstone agent [command]

create

Membuat agen baru dengan konfigurasi kustom.

dropstone agent create

Perintah ini akan memandu Anda melalui pembuatan agen baru dengan system prompt dan konfigurasi izin kustom. Apa pun yang tidak Anda izinkan akan ditolak di frontmatter agen yang dihasilkan.

Flag

Flag	Short	Deskripsi
		Direktori untuk menulis file agen (default ke global atau `.dropstone/agent` berdasarkan prompt)
		Apa yang harus dilakukan agen
		Mode agen: `all`, `primary`, atau `subagent`
		Daftar izin yang dipisahkan koma untuk diizinkan (default: semua). Tersedia: `bash`, `read`, `edit`, `glob`, `grep`, `webfetch`, `task`, `todowrite`, `websearch`, `lsp`, `skill`. Apa pun yang dihilangkan ditolak. Alias: `--tools`
	`-m`	Model yang akan digunakan (`dropstone/dropstone-fast`, `dropstone/dropstone-pro`, atau `dropstone/dropstone-heavy`)

Melewati semua --path, --description, --mode, dan --permissions menjalankan perintah secara non-interaktif.

list

Mencantumkan semua agen yang tersedia.

dropstone agent list

attach

Melampirkan terminal ke server backend Dropstone yang sudah berjalan yang dimulai melalui perintah serve atau web.

dropstone attach [url]

Ini memungkinkan Anda mengarahkan sesi interaktif ke server Dropstone yang berjalan di mesin lain. Contohnya:

# Di mesin host, mulai server
dropstone web --port 4096 --hostname 0.0.0.0

# Di mesin lain, lampirkan sesi ke server tersebut
dropstone attach http://10.20.30.40:4096

Flag

Flag	Short	Deskripsi
		Direktori kerja untuk memulai sesi
	`-c`	Melanjutkan sesi terakhir
	`-s`	ID sesi untuk dilanjutkan
		Fork sesi saat melanjutkan (gunakan dengan `--continue` atau `--session`)
	`-p`	Kata sandi auth dasar (default ke `DROPSTONE_SERVER_PASSWORD`)
	`-u`	Nama pengguna auth dasar (default ke `DROPSTONE_SERVER_USERNAME` atau `dropstone`)

auth

Perintah untuk mengelola kredensial dan login untuk penyedia.

dropstone auth [command]

Gunakan dropstone auth login untuk masuk ke Dropstone. Kredensial Anda disimpan di ~/.local/share/dropstone/auth.json.

dropstone auth login

Dropstone membaca kredensial dari file ini setiap kali diluncurkan.

Flag

Flag	Short	Deskripsi
	`-p`	ID atau nama penyedia untuk masuk
	`-m`	Label metode login yang akan digunakan, melewati pemilihan metode

list

Mencantumkan semua penyedia yang terautentikasi sebagaimana disimpan di file kredensial.

dropstone auth list

Atau versi singkatnya.

dropstone auth ls

logout

Mengeluarkan Anda dari penyedia dengan menghapusnya dari file kredensial.

dropstone auth logout

github

Mengelola agen GitHub untuk otomatisasi repositori.

dropstone github [command]

install

Menginstal agen GitHub di repositori Anda.

dropstone github install

Ini menyiapkan workflow GitHub Actions yang diperlukan dan memandu Anda melalui proses konfigurasi. Pelajari lebih lanjut.

run

Menjalankan agen GitHub. Ini biasanya digunakan di GitHub Actions.

dropstone github run

Flag

Flag	Deskripsi
	Event mock GitHub untuk menjalankan agen
	Token akses pribadi GitHub

mcp

Mengelola server Model Context Protocol.

dropstone mcp [command]

add

Menambahkan server MCP ke konfigurasi Anda.

dropstone mcp add

Perintah ini akan memandu Anda melalui penambahan server MCP lokal atau jarak jauh.

list

Mencantumkan semua server MCP yang dikonfigurasi dan status koneksinya.

dropstone mcp list

Atau gunakan versi singkatnya.

dropstone mcp ls

auth

Mengautentikasi dengan server MCP yang mendukung OAuth.

dropstone mcp auth [name]

Jika Anda tidak memberikan nama server, Anda akan diminta untuk memilih dari server yang mendukung OAuth yang tersedia.

Anda juga dapat mencantumkan server yang mendukung OAuth dan status autentikasinya.

dropstone mcp auth list

Atau gunakan versi singkatnya.

dropstone mcp auth ls

logout

Menghapus kredensial OAuth untuk server MCP.

dropstone mcp logout [name]

debug

Men-debug masalah koneksi OAuth untuk server MCP.

dropstone mcp debug <name>

models

Mencantumkan tier model Dropstone yang tersedia untuk akun Anda.

dropstone models

Output dalam format dropstone/<tier>. Dropstone menyediakan tiga tier:

Model ID	Tier	Terbaik untuk
`dropstone/dropstone-fast`	Fast	Penggerak harian default. Edit cepat, pembuatan kerangka, debugging percakapan.
`dropstone/dropstone-pro`	Pro	Refactor multi-file, perubahan lintas-bagian, penalaran yang lebih luas.
`dropstone/dropstone-heavy`	Heavy	Keputusan arsitektur, migrasi besar, debugging sulit.

Lihat Models untuk rincian lengkap dan cara mengatur default.

Flag

Flag	Deskripsi
	Menyegarkan daftar model yang di-cache
	Menyertakan metadata (jendela konteks, kemampuan)

run

Menjalankan dropstone dalam mode non-interaktif dengan memberikan prompt secara langsung.

dropstone run [message..]

Ini berguna untuk scripting, otomatisasi, atau ketika Anda menginginkan jawaban cepat tanpa membuka sesi interaktif. Contohnya:

dropstone run Jelaskan penggunaan context di Go

Anda juga dapat melampirkan ke instance dropstone serve yang berjalan untuk menghindari waktu boot dingin server MCP pada setiap run:

# Mulai server headless di satu terminal
dropstone serve

# Di terminal lain, jalankan perintah yang melampirkan ke server tersebut
dropstone run --attach http://localhost:4096 "Jelaskan async/await di JavaScript"

Flag

Flag	Short	Deskripsi
		Perintah yang akan dijalankan, gunakan pesan untuk argumen
	`-c`	Melanjutkan sesi terakhir
	`-s`	ID sesi untuk dilanjutkan
		Fork sesi saat melanjutkan (gunakan dengan `--continue` atau `--session`)
		Membagikan sesi
	`-m`	Model yang akan digunakan (`dropstone/dropstone-fast`, `dropstone/dropstone-pro`, atau `dropstone/dropstone-heavy`)
		Agen yang akan digunakan
	`-f`	File yang akan dilampirkan ke pesan
		Format: default (terformat) atau json (event JSON mentah)
		Judul untuk sesi (menggunakan prompt yang dipotong jika tidak ada nilai yang diberikan)
		Lampirkan ke server dropstone yang berjalan (mis., http://localhost:4096)
	`-p`	Kata sandi auth dasar (default ke `DROPSTONE_SERVER_PASSWORD`)
	`-u`	Nama pengguna auth dasar (default ke `DROPSTONE_SERVER_USERNAME` atau `dropstone`)
		Direktori untuk dijalankan, atau jalur di server jarak jauh saat melampirkan
		Port untuk server lokal (default ke port acak)
		Varian model (upaya penalaran khusus penyedia)
		Menampilkan blok pemikiran
		Menyetujui otomatis izin yang tidak ditolak secara eksplisit (berbahaya!)

serve

Memulai server Dropstone headless untuk akses API. Lihat dokumen server untuk antarmuka HTTP lengkap.

dropstone serve

Ini memulai server HTTP headless yang menyediakan akses terprogram ke Dropstone, tanpa membuka sesi interaktif. Setel DROPSTONE_SERVER_PASSWORD untuk mengaktifkan auth dasar HTTP (nama pengguna default ke dropstone).

Flag

Flag	Deskripsi
	Port untuk didengarkan
	Hostname untuk didengarkan
	Aktifkan penemuan mDNS
	Nama domain mDNS kustom
	Origin browser tambahan untuk mengizinkan CORS

session

Mengelola sesi Dropstone.

dropstone session [command]

list

Mencantumkan semua sesi Dropstone.

dropstone session list

Flag

Flag	Short	Deskripsi
	`-n`	Batasi ke N sesi terbaru
		Format output: table atau json (table)

delete

Menghapus sesi Dropstone.

dropstone session delete <sessionID>

stats

Menampilkan statistik penggunaan token dan biaya untuk sesi Dropstone Anda.

dropstone stats

Flag

Flag	Deskripsi
	Tampilkan statistik untuk N hari terakhir (semua waktu)
	Jumlah alat untuk ditampilkan (semua)
	Tampilkan rincian penggunaan model (tersembunyi secara default). Berikan angka untuk menampilkan N teratas
	Filter berdasarkan proyek (semua proyek, string kosong: proyek saat ini)

export

Mengekspor data sesi sebagai JSON.

dropstone export [sessionID]

Jika Anda tidak memberikan ID sesi, Anda akan diminta untuk memilih dari sesi yang tersedia.

Flag

Flag	Deskripsi
	Menyunting data transkrip/file yang sensitif

import

Mengimpor data sesi dari file JSON atau URL berbagi Dropstone.

dropstone import <file>

Anda dapat mengimpor dari file lokal atau URL berbagi Dropstone.

dropstone import session.json
dropstone import https://dropstone.io/s/abc123

web

Memulai server Dropstone headless dengan antarmuka web.

dropstone web

Ini memulai server HTTP dan membuka browser web untuk mengakses Dropstone melalui antarmuka web. Setel DROPSTONE_SERVER_PASSWORD untuk mengaktifkan auth dasar HTTP (nama pengguna default ke dropstone).

Flag

Flag	Deskripsi
	Port untuk didengarkan
	Hostname untuk didengarkan
	Aktifkan penemuan mDNS
	Nama domain mDNS kustom
	Origin browser tambahan untuk mengizinkan CORS

acp

Memulai server ACP (Agent Client Protocol).

dropstone acp

Perintah ini memulai server ACP yang berkomunikasi melalui stdin/stdout menggunakan nd-JSON.

Flag

Flag	Deskripsi
	Direktori kerja
	Port untuk didengarkan
	Hostname untuk didengarkan
	Aktifkan penemuan mDNS
	Nama domain mDNS kustom
	Origin browser tambahan untuk mengizinkan CORS

plugin

Menginstal plugin dan memperbarui konfigurasi Anda.

dropstone plugin <module>

Atau gunakan alias.

dropstone plug <module>

Flag

Flag	Short	Deskripsi
	`-g`	Instal di konfigurasi global
	`-f`	Ganti versi plugin yang ada

pr

Mengambil dan checkout branch PR GitHub, lalu menjalankan Dropstone.

dropstone pr <number>

db

Alat database.

dropstone db [query]

Flag

Flag	Deskripsi
	Format output: `json` atau `tsv`

path

Mencetak jalur database.

dropstone db path

debug

Alat debugging dan pemecahan masalah.

dropstone debug [command]

uninstall

Menghapus instalasi Dropstone dan menghapus semua file terkait.

dropstone uninstall

Flag

Flag	Short	Deskripsi
	`-c`	Pertahankan file konfigurasi
	`-d`	Pertahankan data sesi dan snapshot
		Tampilkan apa yang akan dihapus tanpa menghapus
	`-f`	Lewati prompt konfirmasi

upgrade

Memperbarui Dropstone CLI ke versi terbaru atau versi tertentu. dropstone update adalah alias dan berperilaku identik.

dropstone upgrade [target]
# atau
dropstone update [target]

Untuk meningkatkan ke versi terbaru:

dropstone upgrade

Untuk menginstal versi tertentu:

dropstone upgrade 1.0.5

Di Windows, jika Dropstone sedang berjalan, penginstal menyiapkan build baru sebagai dropstone.exe.pending. Versi baru aktif secara otomatis pada peluncuran berikutnya: tidak perlu memindahkan file secara manual.

Flag

Flag	Short	Deskripsi
	`-m`	Metode instalasi yang akan digunakan: `curl`, `npm`, `pnpm`, `bun`, `brew`, `scoop`, `choco`

Flag Global

Dropstone CLI menerima flag global berikut.

Flag	Short	Deskripsi
	`-h`	Tampilkan bantuan
	`-v`	Cetak nomor versi
		Cetak log ke stderr
		Tingkat log (DEBUG, INFO, WARN, ERROR)
		Jalankan tanpa plugin eksternal

Variabel lingkungan

Dropstone membaca variabel lingkungan berikut saat diluncurkan. Ini adalah variabel yang didukung untuk pengguna; apa pun yang tidak tercantum di sini bersifat internal dan dapat berubah atau dihapus tanpa pemberitahuan.

Variable	Tipe	Deskripsi
`DROPSTONE_API_KEY`	string	Kunci API Dropstone untuk penggunaan headless / CI (melewati masuk browser)
`DROPSTONE_CONFIG`	string	Jalur ke file konfigurasi `dropstone.json`
`DROPSTONE_TUI_CONFIG`	string	Jalur ke file konfigurasi sesi (`tui.json`)
`DROPSTONE_DISABLE_AUTOUPDATE`	boolean	Nonaktifkan pemeriksaan pembaruan CLI otomatis
`DROPSTONE_GIT_BASH_PATH`	string	Jalur ke Git Bash di Windows (digunakan sebagai alat shell)
`DROPSTONE_SERVER_PASSWORD`	string	Aktifkan auth dasar HTTP pada `dropstone serve` / `dropstone web`
`DROPSTONE_SERVER_USERNAME`	string	Ganti nama pengguna auth dasar (default `dropstone`)

Core concepts

Interactive session

CLI

tui

Flag

Perintah

agent

create

Flag

list

attach

Flag

auth

login

Flag

list

logout

github

install

run

Flag

mcp

add

list

auth

logout

debug

models

Flag

run

Flag

serve

Flag

session

list

Flag

delete

stats

Flag

export

Flag

import

web

Flag

acp

Flag

plugin

Flag

pr

db

Flag

path

debug

uninstall

Flag

upgrade

Flag

Flag Global

Variabel lingkungan

Di halaman ini