Panoramica
Dropstone CLI è uno strumento di coding agentico che gira nel tuo terminale. Chiedigli di leggere codice, eseguire comandi, pianificare modifiche e modificare file, tutto dalla tua shell.
Dropstone è il percorso più veloce verso il coding agentico se vivi nel terminale. Questa pagina ti permette di installarlo, accedere e iniziare la tua prima conversazione.
Prerequisiti
- Un emulatore di terminale moderno. Qualsiasi va bene; testiamo con WezTerm, Alacritty, Ghostty e Kitty.
- Un account Dropstone. Registrati su dropstone.io per usare la linea di modelli integrata (Fast, Pro, Heavy).
Installazione
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 inseriscono un singolo binario dropstone nel tuo PATH. Nessun Node, nessuna dipendenza runtime.
Verifica l'installazione:
dropstone --version
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.
Esegui /login dall'interno di Dropstone per cambiare account in seguito.
Scegli un modello
Dropstone offre tre livelli di modelli. Tutti e tre sono ospitati su infrastruttura statunitense e ottimizzati per il coding.
| Livello | Ideale per |
|---|---|
| Fast | Modifiche rapide, scaffolding, refactor di file singoli. Il livello predefinito. |
| Pro | Refactor multi-file, modifiche trasversali, ragionamento più ampio. |
| Heavy | Decisioni architetturali, migrazioni di grandi dimensioni, debug ambiguo o che richiede ricerca. |
Cambia livello durante una sessione con /effort low, /effort medium, /effort high o /effort xhigh. Ctrl+T li scorre. Vedi Modelli per maggiori dettagli.
Inizializza un progetto
All'interno della root di un progetto, esegui:
/init
Dropstone analizza la struttura del tuo progetto e crea un file AGENTS.md nella root del repository. Committalo su git: è qui che codifichi le convenzioni del progetto, i comandi di build e le insidie che Dropstone dovrebbe conoscere a ogni prompt.
Vedi Regole (AGENTS.md) per il formato completo.
Prima conversazione
Sei pronto. Fai domande, richiedi modifiche o pianifica funzionalità.
Chiedi informazioni sul codice
Come viene gestita l'autenticazione in @src/auth/session.ts?
Usa @ per cercare in modo fuzzy i file e fissarli nel prompt.
Pianifica prima di costruire
Premi Tab per passare alla Modalità Piano. In Modalità Piano, Dropstone non può modificare file; descrive solo cosa farebbe.
Aggiungi una colonna "deleted_at" alla tabella delle note. Poi crea una schermata che
elenca le note eliminate di recente con pulsanti di ripristino ed eliminazione definitiva.
Itera sul piano. Quando sei soddisfatto, premi Tab di nuovo per tornare alla Modalità Build e digli di procedere.
Modifiche dirette
Per piccole modifiche, salta il piano:
Aggiungi l'autenticazione a /settings nello stesso modo in cui è gestita in /notes.
Annulla e ripeti
/undo
/redo
/undo annulla il ciclo di modifica precedente e mostra di nuovo il tuo prompt così puoi modificarlo. Eseguilo più volte per tornare indietro ulteriormente. /redo ripete un passaggio annullato.
Utilizzo e limiti
Digita /usage per vedere il tuo utilizzo settimanale, il livello del piano e il conto alla rovescia per il reset. Digita /upgrade per aprire la pagina dei prezzi se vuoi più margine.