Dropstone Docs

Benvenuto in Dropstone

Dropstone è uno strumento di codifica agenziale che vive nel tuo terminale. Legge il tuo codebase, effettua modifiche coordinate tra i file, esegue comandi e spiega il suo ragionamento mentre lavora.

Dropstone running inside a terminal

Descrivi quello che vuoi, e Dropstone legge il codice rilevante, pianifica il cambiamento, modifica i file, esegue comandi e spiega quello che ha fatto. Funziona su progetti reali, non su frammenti di giocattoli, e rimane radicato nel codice che hai già.

Questa pagina ti dà la forma del prodotto. La Quick Start ti guida attraverso l'installazione e il lancio del tuo primo cambiamento.

Installa in secondi

Homebrew (consigliato):

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

O lo script di installazione:

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

Poi entra in qualsiasi progetto:

cd /path/to/your/project
dropstone

Verifica l'installazione con dropstone --version. Al primo avvio ti verrà chiesto di accedere; i dettagli completi dell'accesso sono nella pagina Quick Start.

Quello che puoi fare

Comprendi un codebase

Chiedi come il flusso di autenticazione attraversa il sistema, dove potrebbe nascondersi un bug, o come un modulo è collegato. Dropstone legge i file su richiesta e risponde con citazioni al codice effettivo.

Costruisci funzionalità e correggi bug

Descrivi il cambiamento in linguaggio naturale. Dropstone propone un piano, modifica tra i file e mostra i diff prima che qualcosa venga implementato.

Esegui, testa e verifica

I controlli di tipo, i test e i linter vengono eseguiti automaticamente quando esistono. I fallimenti si riportano nel piano in modo che il risultato sia verde quando lo leggi.

Crea commit e pull request

Genera messaggi di commit convenzionali, esegui il push dei branch e apri PR tramite l'integrazione GitHub o GitLab. Riepiloghi di revisione del codice inclusi.

Connetti i tuoi strumenti con MCP

Collega database, API interne, sistemi di ticketing o qualsiasi server Model Context Protocol. Dropstone li tratta come strumenti di prima classe.

Personalizza con regole e skill

Inserisci un AGENTS.md alla radice del repo per insegnare a Dropstone le tue convenzioni. Pacchetto flussi di lavoro riutilizzabili come skill.

Componi con la shell

Dropstone è un cittadino Unix. La sessione interattiva è la superficie predefinita, ma ogni capacità è disponibile da un'invocazione one-shot, il che la rende scriptabile in CI, pre-commit hook e nei tuoi flussi di lavoro.

# One-shot: fai una domanda ed esci
dropstone run "Explain how the auth middleware works"

# Pipe a file in
dropstone run "Find security issues" < src/auth.ts

# Use it in a shell pipeline
git diff main | dropstone run "Write a PR description for this diff"

# Drive it from CI without a TTY
dropstone run --json "Generate release notes from the last 20 commits"

Come funziona

Dropstone viene eseguito come un singolo binario nel tuo terminale. Non c'è plugin, nessuna estensione e nessun accoppiamento IDE. Lo avvii all'interno di un progetto e opera sui file nella tua directory di lavoro.

Ogni turno segue lo stesso ciclo:

1

Descrivi il compito in linguaggio naturale

Nessuna sintassi speciale. "Aggiungi un endpoint /healthz che restituisce le informazioni di build" è sufficiente.

2

Dropstone raccoglie il contesto

Legge i file, cerca i simboli e ispeziona la struttura finché non ha abbastanza per agire.

3

Propone ed esegue un piano

Le modifiche vengono mostrate come diff. I comandi della shell chiedono il permesso a meno che non li abbia inseriti nella whitelist.

4

Verifica il risultato

I controlli di tipo, i test e i linter vengono eseguiti automaticamente quando esistono. I fallimenti si riportano nel piano.

L'intera interazione rimane nel tuo terminale. Il tuo codice non viene mai inviato da nessuna parte se non al provider di inferenza che hai configurato, e l'inferenza ospitata di Dropstone è gestita secondo una politica di no-retention e no-training. Vedi la pagina Trust per i dettagli.

Usa Dropstone ovunque

Voglio…Opzione migliore
Avviare una sessione di codifica interattivaEsegui dropstone nella directory del tuo progetto
Fare una domanda una tantum senza una sessionedropstone run "..." o esegui il pipe di un file con <
Riprendere l'ultima sessionedropstone --continue (o dropstone -c)
Collegare uno strumento personalizzato o un'API internaMCP Servers
Insegnare a Dropstone le convenzioni del tuo repoInserisci un AGENTS.md alla radice del repo
Pacchetto un flusso di lavoro riutilizzabileSkills e Plugins
Usa Dropstone in CI o pre-commitdropstone run con --json e il modello permissions
Scegli il giusto livello di modello per il compitoModels (Fast / Pro / Heavy)
Esegui all'interno di una sandbox o shell limitataPermissions

Costruito attorno a tre livelli di modello

Scegli il modello che si adatta al lavoro. Tutti e tre sono ospitati su infrastrutture statunitensi e sintonizzati per la codifica.

Fast

Dropstone Fast

DeepSeek V4 Flash
Modifiche rapide, scaffolding, refactor di singoli file e debug conversazionale. Primo token sub-secondo. Il livello predefinito per le nuove sessioni.
ProConsigliato

Dropstone Pro

DeepSeek V4 Pro
Refactor multi-file, cambiamenti trasversali e compiti che richiedono un ragionamento più ampio. Passa con /effort high.
Heavy

Dropstone Heavy

Kimi K2.6
Decisioni architettoniche, migrazioni di grandi dimensioni e debug difficili. Ragionamento più profondo, budget di pensiero più lungo. Passa con /effort xhigh.

Suggerimento:

Non devi pensare alla selezione del modello in anticipo. Inizia con Fast e usa /effort da dentro Dropstone per salire quando un compito ha bisogno di più profondità.

Dove andare dopo

1

Inizia e mettiti in funzione

La Quickstart copre l'installazione, l'accesso e il tuo primo compito.

2

Scegli un livello di modello

Models approfondisce Fast, Pro e Heavy, e Providers copre il tuo.

3

Configura a tuo piacimento

Configuration copre le impostazioni globali e per progetto; Permissions e Keybindings coprono il resto.

4

Vedi cosa c'è di nuovo

Il Changelog elenca ogni versione con i cambiamenti visibili all'utente.

Una volta configurato, il CLI reference e la slash commands guide sono le due pagine a cui tornerai più spesso.


Stai costruendo un agent o un'app LLM che ha bisogno di leggere questi documenti? Puntalo a /llms.txt per un indice del sito, o /llms-full.txt per il corpus completo in un file.

Ctrl+I