Dropstone Docs

Benvenuto in Dropstone

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

Dropstone in esecuzione all'interno di un terminale

Descrivi ciò che vuoi, e Dropstone legge il codice pertinente, pianifica la modifica, modifica i file, esegue comandi e spiega cosa ha fatto. Funziona su progetti reali, non su snippet di esempio, e resta ancorato al codice che già possiedi.

Questa pagina ti dà una panoramica del prodotto. La Guida rapida ti accompagna nell'installazione e nella realizzazione della tua prima modifica.

Installazione in pochi secondi

Homebrew (consigliato):

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

Oppure 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 sull'accesso sono nella pagina Guida rapida.

Cosa puoi fare

Comprendere un codebase

Chiedi come scorre l'autenticazione nel sistema, dove potrebbe nascondersi un bug o come è collegato un modulo. Dropstone legge i file su richiesta e risponde con citazioni al codice effettivo.

Creare funzionalità e correggere bug

Descrivi la modifica in linguaggio semplice. Dropstone propone un piano, modifica più file e mostra i diff prima che qualsiasi cosa venga applicata.

Eseguire, testare e verificare

Type check, test e lint vengono eseguiti automaticamente quando esistono. Gli errori vengono reincorporati nel piano, così il risultato è pulito quando lo leggi.

Creare commit e pull request

Genera messaggi di commit convenzionali, pubblica branch e apri PR tramite l'integrazione con GitHub o GitLab. Riepilogo della code review incluso.

Collega i tuoi strumenti con MCP

Integra 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 file AGENTS.md nella radice del repository per insegnare a Dropstone le tue convenzioni. Raccogli flussi di lavoro riutilizzabili come skill.

Componi con la shell

Dropstone è un cittadino Unix. La sessione interattiva è l'interfaccia predefinita, ma ogni funzionalità è disponibile anche tramite un'invocazione one-shot, che lo rende scriptabile in CI, hook pre-commit e nei tuoi flussi di lavoro.

# One-shot: fai una domanda ed esci
dropstone run "Spiega come funziona il middleware di autenticazione"

# Passa un file tramite pipe
dropstone run "Trova problemi di sicurezza" < src/auth.ts

# Usalo in una pipeline della shell
git diff main | dropstone run "Scrivi una descrizione della PR per questo diff"

# Guidalo dalla CI senza TTY
dropstone run --json "Genera le note di rilascio dagli ultimi 20 commit"

Come funziona

Dropstone viene eseguito come un singolo binario nel tuo terminale. Niente da configurare, nessun runtime da installare: lo avvii all'interno di un progetto e opera sui file nella tua directory di lavoro. Se preferisci averlo accanto al codice come pannello, esiste anche Dropstone per VS Code.

Ogni turno segue lo stesso ciclo:

1

Descrivi l'attività in linguaggio semplice

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 ed esamina la struttura finché non ha abbastanza informazioni per agire.

3

Propone ed esegue un piano

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

4

Verifica il risultato

Type check, test e lint vengono eseguiti automaticamente quando esistono. Gli errori vengono reincorporati nel piano.

L'intera interazione rimane nel tuo terminale. Il tuo codice non viene mai inviato da nessuna parte, tranne che all'inferenza di Dropstone, gestita secondo una policy di non-conservazione e non-addestramento. Consulta la pagina Trust per i dettagli.

Usa Dropstone ovunque

Voglio…Opzione migliore
Avviare una sessione di coding interattivaEsegui dropstone nella directory del tuo progetto
Fare una domanda una tantum senza sessionedropstone run "..." oppure passa un file con <
Riprendere l'ultima sessionedropstone --continue (oppure dropstone -c)
Integrare uno strumento personalizzato o un'API internaServer MCP
Insegnare a Dropstone le convenzioni del tuo repositoryInserisci un AGENTS.md nella radice del repository
Confezionare un flusso di lavoro riutilizzabileSkill e Plugin
Usare Dropstone in CI o pre-commitdropstone run con --json e il modello di permessi
Scegliere il livello di modello giusto per l'attivitàModelli (Fast / Pro / Heavy)
Eseguire in una sandbox o shell ristrettaPermessi

Costruito attorno a tre livelli di modello

Scegli il modello più adatto al lavoro. Tutti e tre sono ospitati su infrastruttura statunitense e ottimizzati per il coding.

Fast

Dropstone Fast

Modifiche rapide, scaffolding, refactor di file singoli e debug conversazionale. Primo token in meno di un secondo. Il livello predefinito per le nuove sessioni.
ProConsigliato

Dropstone Pro

Refactor multi-file, modifiche trasversali e attività che richiedono un ragionamento più ampio. Passa con /effort high.
Heavy

Dropstone Heavy

Decisioni architetturali, 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 dall'interno di Dropstone per salire di livello quando un'attività richiede più profondità.

Dove andare dopo

1

Mettiti in funzione

La Guida rapida copre installazione, accesso e il tuo primo compito.

2

Scegli un livello di modello

Modelli approfondisce Fast, Pro e Heavy e quando ricorrere a ciascuno.

3

Configura a tuo piacimento

Configurazione copre le impostazioni globali e per progetto; Permessi e Scorciatoie da tastiera coprono il resto.

4

Scopri le novità

Il Changelog elenca ogni release con le modifiche visibili all'utente.

Una volta configurato, il riferimento CLI e la guida ai comandi slash sono le due pagine a cui tornerai più spesso.


Stai creando un agente o un'app LLM che deve leggere questi documenti? Punta a /llms.txt per un indice del sito, oppure a /llms-full.txt per l'intero corpus in un unico file.

Ctrl+I