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 agente funzionante.

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

Prima di iniziare

Ti serve:

Un terminale o 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 sul 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 controlla gli aggiornamenti all'avvio e li installa, così resti aggiornato senza dover rieseguire l'installer. Se hai installato con Homebrew, usa brew upgrade dropstone — Homebrew possiede quel binario e Dropstone non lo toccherà.

Passo 2: Accedi

Spostati in qualsiasi 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 così 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 scrivi
I comandi slash iniziano con /. Prova /help per vederli tutti

Scrivi 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:

what does this project do?

what are the main entry points?

explain the folder structure

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:

what can you do in this project?

what commands have you been given permission to run?

Passo 5: Fai la tua prima modifica al codice

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

add a README with a one-paragraph project description

Per un progetto esistente:

add input validation to the function that creates a user

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 richiedere di nuovo. Usa /permissions per visualizzare o revocare ciò che hai consentito.

Passo 6: Lavora con git

Dropstone tratta git come uno strumento di prima classe:

what files have I changed?

commit my changes with a descriptive message

create a branch called feature/health-endpoint and switch to it

show the last five commits

help me resolve the merge conflict in src/auth.ts

Per 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à.

there is a bug where empty search queries return all results - fix it

add a /healthz endpoint to the API server that returns build info

the login form crashes when the email is missing - figure out why and fix it

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 schemi in cui Dropstone è bravo:

Refactoring

refactor the auth module to use async/await instead of callbacks

Scrivere test

write unit tests for the calculator functions

Revisione del codice

review my staged changes and flag anything risky

Documentazione

update the README install instructions to include the WSL path

Tip

Parla con Dropstone come con 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à una tantum ed esce	`dropstone run "explain 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.

Consigli utili per nuovi utenti

Cosa fare dopo

Riferimento CLI

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

Comandi slash

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

Insegna a Dropstone il tuo repository (AGENTS.md)

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

Connetti i tuoi strumenti (MCP)

Collega database, API interne, sistemi di ticketing o qualsiasi cosa parli 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 richiedi una funzionalità su dropstone.io/contact

Overview

Pricing