Guida rapida

Installa Dropstone, accedi e invia la tua prima modifica in meno di cinque minuti. Questa guida ti porta da zero a un ciclo di agente funzionante.

Alla fine di questa guida avrai Dropstone installato, effettuato l'accesso e prodotto modifiche reali in un progetto a tua scelta.

Prima di iniziare

Ti serve:

Un terminale o un prompt dei comandi
Un progetto su disco a cui puntare Dropstone (qualsiasi linguaggio, qualsiasi dimensione)
Un account Dropstone, che puoi creare su dropstone.io

Passo 1: Installa Dropstone

Scegli il percorso di installazione per la tua piattaforma.

Homebrew (consigliato):

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

Oppure lo script di installazione:

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

Entrambi i metodi installano un singolo binario dropstone nel tuo PATH. Nessun Node, nessuna dipendenza runtime.

Verifica l'installazione:

dropstone --version

Dovresti vedere un numero di versione (la release corrente è 1.0.8). Il binario si aggiorna automaticamente in background, quindi rimani aggiornato senza dover rieseguire l'installer.

Passo 2: Accedi

Spostati in una directory di progetto e avvia Dropstone:

cd /path/to/your/project
dropstone

Al primo avvio ti verrà chiesto di accedere. Due opzioni:

Continua nel browser (consigliato). Apre dropstone.io/login, ti fa accedere e restituisce il token al CLI automaticamente. Usa PKCE, quindi il token non appare mai nella barra degli indirizzi del browser.
Incolla un token. Per sessioni SSH o headless. Ottieni un token su dropstone.io/account e incollalo.

Le tue credenziali vengono salvate su disco dopo il primo accesso. Per cambiare account in seguito, esegui /login dall'interno di Dropstone.

Passo 3: Avvia la tua prima sessione

Ora stai guardando la schermata iniziale di Dropstone. Tre cose da notare:

Il tuo livello di modello corrente è mostrato in alto a destra (predefinito: Dropstone Fast)
La casella di input in basso è dove digiti
I comandi slash iniziano con /. Prova /help per vederli tutti

Digita qualsiasi prompt in linguaggio naturale per avviare una sessione. Non c'è sintassi speciale da imparare.

Passo 4: Fai la tua prima domanda

Lascia che Dropstone esplori il progetto per te. Prova uno di questi:

cosa fa questo progetto?

quali sono i punti di ingresso principali?

spiega la struttura delle cartelle

Dropstone leggerà i file su richiesta e risponderà con citazioni al codice reale. Non devi incollare file o scrivere contesto manualmente.

Puoi anche chiedere a Dropstone di se stesso:

cosa puoi fare in questo progetto?

quali comandi ti è stato permesso di eseguire?

Passo 5: Fai la tua prima modifica al codice

Ora descrivi una piccola modifica. Per un nuovo progetto, prova qualcosa a basso rischio:

aggiungi un README con una descrizione del progetto in un paragrafo

Per un progetto esistente:

aggiungi la validazione dell'input alla funzione che crea un utente

Dropstone:

Troverà il file pertinente
Mostrerà la modifica proposta come diff
Chiederà la tua approvazione prima di scrivere
Verificherà il risultato (type check, test, lint se disponibili)

Permessi:

Dropstone chiede l'approvazione la prima volta che vuole modificare un file o eseguire un comando shell. Approva una volta e la stessa operazione nella stessa sessione verrà eseguita senza ulteriori richieste. Usa /permissions per visualizzare o revocare ciò che hai consentito.

Passo 6: Lavora con git

Dropstone tratta git come uno strumento di prima classe:

quali file ho modificato?

committa le mie modifiche con un messaggio descrittivo

crea un branch chiamato feature/health-endpoint e passaci

mostra gli ultimi cinque commit

aiutami a risolvere il conflitto di merge in src/auth.ts

Per i flussi di lavoro a livello di PR (apertura di pull request, generazione di descrizioni PR, pubblicazione di commenti di revisione), consulta Integrazione GitHub.

Passo 7: Correggi un bug o aggiungi una funzionalità

Descrivi ciò che vuoi in linguaggio semplice. Dropstone individuerà il codice, comprenderà il contesto, implementerà la modifica e la verificherà.

c'è un bug per cui le query di ricerca vuote restituiscono tutti i risultati - correggilo

aggiungi un endpoint /healthz al server API che restituisce le informazioni di build

il modulo di login va in crash quando l'email manca - scopri perché e correggilo

Se l'attività coinvolge più file, Dropstone scriverà un breve piano e lo eseguirà passo dopo passo. Puoi premere Esc in qualsiasi momento per interrompere e guidare.

Passo 8: Prova altri flussi di lavoro comuni

Alcuni modelli in cui Dropstone è bravo:

Refactoring

rifattorizza il modulo auth per usare async/await invece dei callback

Scrivere test

scrivi unit test per le funzioni della calcolatrice

Revisione del codice

rivedi le mie modifiche in staging e segnala qualsiasi cosa rischiosa

Documentazione

aggiorna le istruzioni di installazione del README per includere il percorso WSL

Suggerimento:

Parla a Dropstone come a un compagno di squadra. Descrivi ciò che vuoi ottenere, non i passaggi esatti per arrivarci. L'agente è al meglio nella pianificazione quando lasci a lui le scelte di implementazione.

Comandi essenziali

I pochi comandi che userai davvero:

Comando	Cosa fa	Esempio
`dropstone`	Avvia una sessione interattiva nella directory corrente	`dropstone`
`dropstone run "task"`	Esegue un'attività singola ed esce	`dropstone run "spiega auth.ts"`
`dropstone -c`	Continua l'ultima sessione in questa directory	`dropstone -c`
`dropstone --session ID`	Riprende una sessione specifica tramite id	`dropstone --session 7f3a...`
`/help`	Mostra tutti i comandi slash	dentro una sessione
`/effort`	Cambia il livello di modello per questa sessione	`/effort high`
`/clear`	Cancella la conversazione corrente	dentro una sessione
`/login`	Cambia account	dentro una sessione
`exit` o `Ctrl+D`	Esci da Dropstone

Il riferimento completo è nelle pagine CLI e comandi slash.

Suggerimenti per i nuovi utenti

Cosa fare dopo

Riferimento CLI

Ogni flag, ogni sottocomando, ogni opzione. La pagina da mettere nei preferiti.

Comandi slash

Ogni comando slash in un unico posto. Torna utile dopo una settimana di utilizzo.

Insegna a Dropstone il tuo repo (AGENTS.md)

Metti un file nella radice del repo che dice a Dropstone le tue convenzioni, i comandi di build e i punti critici.

Connetti i tuoi strumenti (MCP)

Collega database, API interne, sistemi di ticketing o qualsiasi cosa parli il Model Context Protocol.

Modelli & provider

Maggiori informazioni su Fast 1.6, Pro 1.6 e Heavy 1.6, oltre a come impostare un predefinito nella tua configurazione.

Permessi

Controlla esattamente cosa Dropstone può leggere, scrivere ed eseguire nei tuoi progetti.

Ottenere aiuto

Dentro Dropstone, digita /help o chiedi in linguaggio semplice ("come cambio modello?")
Sfoglia il resto della documentazione su docs.dropstone.io
Segnala un problema o una richiesta di funzionalità su dropstone.io/contact

Overview

Pricing