Dropstone Docs

Sessione interattiva

Come lavorare all'interno di una sessione Dropstone. Riferimenti ai file, shell escape, slash command e integrazione dell'editor.

Dropstone viene eseguito come una sessione interattiva nel tuo terminale. Ogni sessione è legata alla directory da cui l'hai avviata, mantiene la cronologia della conversazione e rimane aperta finché non esci. Questa pagina spiega come gestire una sessione: come fare riferimento ai file, eseguire comandi shell, usare slash command e connettere un editor esterno.

Avvia una sessione

Esegui dropstone dall'interno di un progetto:

dropstone

Oppure puntalo a una directory specifica:

dropstone /path/to/project

Una volta che Dropstone è attivo, digita qualsiasi prompt in linguaggio naturale:

Give me a quick summary of the codebase.

Riferimenti ai file

Fai riferimento ai file nei tuoi messaggi con @. Questo esegue una ricerca fuzzy nella directory di lavoro corrente.

How is auth handled in @src/api/index.ts?

Il contenuto del file viene aggiunto automaticamente alla conversazione, in modo che l'agente possa leggerlo senza doverlo cercare prima.

Comandi shell

Inizia un messaggio con ! per eseguire un comando shell. L'output viene aggiunto alla conversazione come risultato dello strumento in modo che l'agente possa reagire.

!ls -la
!git diff

Slash command

Digita / seguito dal nome del comando per eseguire un'azione rapida. La maggior parte ha un collegamento da tastiera usando ctrl+x come tasto leader (configurabile tramite Keybindings).

/help

compact

Compatta la sessione corrente. Il contesto più vecchio viene riassunto in modo che il lavoro più recente abbia spazio. Alias: /summarize.

Keybind: ctrl+x c

details

Attiva/disattiva se i dettagli dell'esecuzione dello strumento vengono mostrati inline.

editor

Apri il tuo editor esterno per comporre un messaggio più lungo. Utilizza l'editor impostato in EDITOR. Vedi Editor setup.

Keybind: ctrl+x e

effort

Regola la profondità del ragionamento del modello attivo. Apre un selettore con quattro livelli: low, medium, high, xhigh. Uno sforzo maggiore produce un ragionamento più profondo al costo di più crediti e una latenza leggermente superiore. Alias: /thinking.

exit

Esci da Dropstone. Aliases: /quit, /q.

Keybind: ctrl+x q

export

Esporta la conversazione corrente in Markdown e aprila nel tuo editor (utilizza EDITOR).

Keybind: ctrl+x x

help

Mostra la finestra di aiuto con ogni slash command e keybind.

init

Configurazione guidata per creare o aggiornare AGENTS.md. Vedi Rules (AGENTS.md).

models

Elenca i modelli disponibili per questa sessione.

Keybind: ctrl+x m

new

Avvia una nuova sessione nella directory corrente. Alias: /clear.

Keybind: ctrl+x n

redo

Ripeti un messaggio precedentemente annullato. Disponibile solo dopo /undo. Le modifiche ai file vengono ripristinate come parte della ripetizione.

Requires Git:

Undo e redo utilizzano Git per gestire gli snapshot dello stato dei file, quindi il tuo progetto deve essere un repository Git.

Keybind: ctrl+x r

sessions

Elenca e passa da una sessione all'altra. Aliases: /resume, /continue.

Keybind: ctrl+x l

undo

Annulla l'ultimo messaggio nella conversazione. Rimuove il messaggio utente più recente, tutte le risposte successive e qualsiasi modifica ai file apportata in questi turni.

Requires Git:

Undo utilizza Git per ripristinare le modifiche ai file, quindi il tuo progetto deve essere un repository Git.

Keybind: ctrl+x u

upgrade

Apri la pagina dei prezzi di Dropstone per aggiornare il tuo piano. Usalo quando hai bisogno di più crediti settimanali o accesso a livelli premium (Dropstone Pro, Dropstone Heavy).

Plan upgrade vs CLI upgrade:

/upgrade è l'aggiornamento del piano. Per aggiornare il binario Dropstone CLI stesso, esegui dropstone update dalla tua shell.

usage

Mostra il consumo di crediti della settimana corrente, il nome del piano, il limite settimanale e quando i crediti verranno ripristinati.

Editor setup

I comandi /editor e /export avviano l'editor nella tua variabile di ambiente EDITOR.

# Terminal editors
export EDITOR=nano
export EDITOR=vim

# GUI editors (VS Code, Cursor, VSCodium, Windsurf, Zed, etc.)
# require --wait so the editor process blocks until closed
export EDITOR="code --wait"

Per rendere questo permanente, aggiungilo al tuo profilo shell (~/.bashrc, ~/.zshrc, ecc.).

Opzioni popolari:

  • code per Visual Studio Code
  • cursor per Cursor
  • windsurf per Windsurf
  • nvim per Neovim
  • vim per Vim
  • nano per Nano
  • subl per Sublime Text
  • notepad per Windows Notepad

The --wait flag:

Gli editor GUI come VS Code ritornano immediatamente per impostazione predefinita, il che salterebbe il tuo messaggio. Il flag --wait fa sì che il processo dell'editor si blocchi finché non chiudi il file, in modo che Dropstone possa leggere quello che hai scritto.

Personalizzazione

Alcune preferenze a livello di sessione si trovano nella tavolozza dei comandi (Ctrl+P). Cerca quello che vuoi cambiare; l'impostazione viene ricordata tra le sessioni.

  • Hide username: rimuove il tuo nome utente dai messaggi della chat
  • Diff style: scegli tra adattivo (predefinito) e diff impilati a colonna singola
  • Mouse capture: attiva/disattiva se il terminale gestisce la selezione del mouse stesso o se lo fa Dropstone

Per tutto il resto (keybind, formattatori, formato del file di configurazione), vedi le pagine dedicate: Keybindings, Formatters, Configuration.

Privacy e conservazione dei dati

I tuoi prompt, il codice e i trascritti delle conversazioni non vengono mai utilizzati per addestrare i modelli e non vengono conservati oltre la durata della tua sessione. Dropstone utilizza la memorizzazione nella cache dei prompt con ambito di sessione per ridurre i costi e la latenza, nello stesso modo in cui lo fanno Anthropic e OpenAI: il contenuto memorizzato nella cache è isolato al tuo account, scade automaticamente e non viene mai riutilizzato per nessun altro utente o inviato all'addestramento del modello.

Questi controlli sono applicati e revisionati da Blankline, la società madre di Dropstone. Il team di conformità di Blankline controlla la gestione dei dati di Dropstone su base ricorrente e mantiene l'autorità di revoca sull'accesso in produzione di qualsiasi individuo o sistema che violi la politica.

Vedi la Trust page per la postura completa, incluse le divulgazioni dei subprocessori e il limite di sicurezza del runtime.

Ctrl+I