CLI

Opzioni e comandi di Dropstone CLI.

Dropstone CLI per impostazione predefinita avvia una sessione interattiva quando eseguito senza argomenti.

dropstone

Ma accetta anche comandi come documentato in questa pagina. Questo ti permette di interagire con Dropstone a livello programmatico.

dropstone run "Explain how closures work in JavaScript"

tui

Avvia una sessione Dropstone interattiva. Questo è il comportamento predefinito quando esegui dropstone senza sottocomandi; dropstone tui è la forma esplicita.

dropstone [project]

Flag

Flag	Short	Descrizione
	`-c`	Continua l'ultima sessione
	`-s`	ID della sessione da continuare
		Crea un fork della sessione quando continui (usa con `--continue` o `--session`)
		Prompt da utilizzare
	`-m`	Modello da utilizzare (`dropstone/dropstone-fast`, `dropstone/dropstone-pro`, o `dropstone/dropstone-heavy`)
		Agente da utilizzare
		Porta su cui ascoltare
		Nome host su cui ascoltare
		Abilita il rilevamento mDNS
		Nome di dominio mDNS personalizzato
		Origine(i) browser aggiuntiva(e) da consentire per CORS

Comandi

Dropstone CLI ha anche i seguenti comandi.

agent

Gestisci gli agenti per Dropstone.

dropstone agent [command]

create

Crea un nuovo agente con configurazione personalizzata.

dropstone agent create

Questo comando ti guiderà attraverso la creazione di un nuovo agente con un prompt di sistema personalizzato e una configurazione dei permessi. Tutto ciò che non consenti è negato nel frontmatter dell'agente generato.

Flag

Flag	Short	Descrizione
		Directory in cui scrivere il file dell'agente (per impostazione predefinita globale o `.dropstone/agent` in base al prompt)
		Cosa dovrebbe fare l'agente
		Modalità agente: `all`, `primary`, o `subagent`
		Elenco separato da virgole dei permessi da consentire (predefinito: tutti). Disponibili: `bash`, `read`, `edit`, `glob`, `grep`, `webfetch`, `task`, `todowrite`, `websearch`, `lsp`, `skill`. Tutto ciò che è omesso è negato. Alias: `--tools`
	`-m`	Modello da utilizzare (`dropstone/dropstone-fast`, `dropstone/dropstone-pro`, o `dropstone/dropstone-heavy`)

Passare tutti --path, --description, --mode, e --permissions esegue il comando in modo non interattivo.

list

Elenca tutti gli agenti disponibili.

dropstone agent list

attach

Allega un terminale a un server backend Dropstone già in esecuzione avviato tramite i comandi serve o web.

dropstone attach [url]

Questo ti permette di puntare una sessione interattiva a un server Dropstone in esecuzione su un'altra macchina. Ad esempio:

# Sulla macchina host, avvia il server
dropstone web --port 4096 --hostname 0.0.0.0

# Su un'altra macchina, allega una sessione ad esso
dropstone attach http://10.20.30.40:4096

Flag

Flag	Short	Descrizione
		Directory di lavoro in cui avviare la sessione
	`-c`	Continua l'ultima sessione
	`-s`	ID della sessione da continuare
		Crea un fork della sessione quando continui (usa con `--continue` o `--session`)
	`-p`	Password di autenticazione di base (per impostazione predefinita `DROPSTONE_SERVER_PASSWORD`)
	`-u`	Nome utente di autenticazione di base (per impostazione predefinita `DROPSTONE_SERVER_USERNAME` o `dropstone`)

auth

Comando per gestire le credenziali e l'accesso per i provider.

dropstone auth [command]

Usa dropstone auth login per accedere a Dropstone. Le tue credenziali sono archiviate in ~/.local/share/dropstone/auth.json.

dropstone auth login

Dropstone legge le credenziali da questo file ad ogni avvio.

Flag

Flag	Short	Descrizione
	`-p`	ID o nome del provider per accedere
	`-m`	Etichetta del metodo di accesso da utilizzare, saltando la selezione del metodo

list

Elenca tutti i provider autenticati come archiviati nel file delle credenziali.

dropstone auth list

O la versione breve.

dropstone auth ls

logout

Ti disconnette da un provider cancellando dal file delle credenziali.

dropstone auth logout

github

Gestisci l'agente GitHub per l'automazione del repository.

dropstone github [command]

install

Installa l'agente GitHub nel tuo repository.

dropstone github install

Questo configura il flusso di lavoro GitHub Actions necessario e ti guida attraverso il processo di configurazione. Scopri di più.

run

Esegui l'agente GitHub. Questo è tipicamente utilizzato in GitHub Actions.

dropstone github run

Flag

Flag	Descrizione
	Evento GitHub simulato per cui eseguire l'agente
	Token di accesso personale GitHub

mcp

Gestisci i server Model Context Protocol.

dropstone mcp [command]

add

Aggiungi un server MCP alla tua configurazione.

dropstone mcp add

Questo comando ti guiderà attraverso l'aggiunta di un server MCP locale o remoto.

list

Elenca tutti i server MCP configurati e il loro stato di connessione.

dropstone mcp list

O usa la versione breve.

dropstone mcp ls

auth

Autentica con un server MCP abilitato per OAuth.

dropstone mcp auth [name]

Se non fornisci un nome di server, ti verrà chiesto di selezionare dai server disponibili con OAuth.

Puoi anche elencare i server MCP con OAuth e il loro stato di autenticazione.

dropstone mcp auth list

O usa la versione breve.

dropstone mcp auth ls

logout

Rimuovi le credenziali OAuth per un server MCP.

dropstone mcp logout [name]

debug

Esegui il debug dei problemi di connessione OAuth per un server MCP.

dropstone mcp debug <name>

models

Elenca i livelli di modello Dropstone disponibili per il tuo account.

dropstone models

L'output è nel formato dropstone/<tier>. Dropstone include tre livelli:

ID Modello	Livello	Migliore per
`dropstone/dropstone-fast`	Fast	Driver quotidiano predefinito. Modifiche rapide, scaffolding, debug conversazionale.
`dropstone/dropstone-pro`	Pro	Refactoring multi-file, modifiche trasversali, ragionamento più ampio.
`dropstone/dropstone-heavy`	Heavy	Decisioni architettoniche, migrazioni di grandi dimensioni, debug difficile.

Vedi Models per la suddivisione completa e come impostare un valore predefinito.

Flag

Flag	Descrizione
	Aggiorna l'elenco dei modelli in cache
	Includi metadati (finestra di contesto, capacità)

run

Esegui dropstone in modalità non interattiva passando direttamente un prompt.

dropstone run [message..]

Questo è utile per scripting, automazione, o quando vuoi una risposta rapida senza aprire una sessione interattiva. Ad esempio:

dropstone run Explain the use of context in Go

Puoi anche allacciare a un'istanza dropstone serve in esecuzione per evitare i tempi di avvio a freddo del server MCP ad ogni esecuzione:

# Avvia un server headless in un terminale
dropstone serve

# In un altro terminale, esegui comandi che si allacciano ad esso
dropstone run --attach http://localhost:4096 "Explain async/await in JavaScript"

Flag

Flag	Short	Descrizione
		Il comando da eseguire, usa message per gli argomenti
	`-c`	Continua l'ultima sessione
	`-s`	ID della sessione da continuare
		Crea un fork della sessione quando continui (usa con `--continue` o `--session`)
		Condividi la sessione
	`-m`	Modello da utilizzare (`dropstone/dropstone-fast`, `dropstone/dropstone-pro`, o `dropstone/dropstone-heavy`)
		Agente da utilizzare
	`-f`	File da allegare al messaggio
		Formato: default (formattato) o json (eventi JSON grezzi)
		Titolo per la sessione (usa il prompt troncato se non viene fornito alcun valore)
		Allaccia a un server dropstone in esecuzione (ad es. http://localhost:4096)
	`-p`	Password di autenticazione di base (per impostazione predefinita `DROPSTONE_SERVER_PASSWORD`)
	`-u`	Nome utente di autenticazione di base (per impostazione predefinita `DROPSTONE_SERVER_USERNAME` o `dropstone`)
		Directory in cui eseguire, o percorso sul server remoto quando si allaccia
		Porta per il server locale (per impostazione predefinita porta casuale)
		Variante del modello (sforzo di ragionamento specifico del provider)
		Mostra i blocchi di pensiero
		Approva automaticamente i permessi che non sono esplicitamente negati (pericoloso!)

serve

Avvia un server Dropstone headless per l'accesso API. Consulta la documentazione del server per l'interfaccia HTTP completa.

dropstone serve

Questo avvia un server HTTP headless che fornisce accesso programmatico a Dropstone, senza aprire una sessione interattiva. Imposta DROPSTONE_SERVER_PASSWORD per abilitare l'autenticazione HTTP basic (il nome utente per impostazione predefinita è dropstone).

Flag

Flag	Descrizione
	Porta su cui ascoltare
	Nome host su cui ascoltare
	Abilita il rilevamento mDNS
	Nome di dominio mDNS personalizzato
	Origine(i) browser aggiuntiva(e) da consentire per CORS

session

Gestisci le sessioni Dropstone.

dropstone session [command]

list

Elenca tutte le sessioni Dropstone.

dropstone session list

Flag

Flag	Short	Descrizione
	`-n`	Limita alle N sessioni più recenti
		Formato di output: table o json (table)

delete

Elimina una sessione Dropstone.

dropstone session delete <sessionID>

stats

Mostra le statistiche di utilizzo dei token e dei costi per le tue sessioni Dropstone.

dropstone stats

Flag

Flag	Descrizione
	Mostra le statistiche degli ultimi N giorni (tutto il tempo)
	Numero di strumenti da mostrare (tutti)
	Mostra la suddivisione dell'utilizzo del modello (nascosto per impostazione predefinita). Passa un numero per mostrare i top N
	Filtra per progetto (tutti i progetti, stringa vuota: progetto corrente)

export

Esporta i dati della sessione come JSON.

dropstone export [sessionID]

Se non fornisci un ID di sessione, ti verrà chiesto di selezionare dalle sessioni disponibili.

Flag

Flag	Descrizione
	Redigi i dati sensibili del trascritto/file

import

Importa i dati della sessione da un file JSON o da un URL di condivisione Dropstone.

dropstone import <file>

Puoi importare da un file locale o da un URL di condivisione Dropstone.

dropstone import session.json
dropstone import https://dropstone.io/s/abc123

web

Avvia un server Dropstone headless con un'interfaccia web.

dropstone web

Questo avvia un server HTTP e apre un browser web per accedere a Dropstone tramite un'interfaccia web. Imposta DROPSTONE_SERVER_PASSWORD per abilitare l'autenticazione HTTP basic (il nome utente per impostazione predefinita è dropstone).

Flag

Flag	Descrizione
	Porta su cui ascoltare
	Nome host su cui ascoltare
	Abilita il rilevamento mDNS
	Nome di dominio mDNS personalizzato
	Origine(i) browser aggiuntiva(e) da consentire per CORS

acp

Avvia un server ACP (Agent Client Protocol).

dropstone acp

Questo comando avvia un server ACP che comunica tramite stdin/stdout utilizzando nd-JSON.

Flag

Flag	Descrizione
	Directory di lavoro
	Porta su cui ascoltare
	Nome host su cui ascoltare
	Abilita il rilevamento mDNS
	Nome di dominio mDNS personalizzato
	Origine(i) browser aggiuntiva(e) da consentire per CORS

plugin

Installa un plugin e aggiorna la tua configurazione.

dropstone plugin <module>

O usa l'alias.

dropstone plug <module>

Flag

Flag	Short	Descrizione
	`-g`	Installa nella configurazione globale
	`-f`	Sostituisci la versione del plugin esistente

pr

Recupera e fai il checkout di un ramo GitHub PR, quindi esegui Dropstone.

dropstone pr <number>

db

Strumenti di database.

dropstone db [query]

Flag

Flag	Descrizione
	Formato di output: `json` o `tsv`

path

Stampa il percorso del database.

dropstone db path

debug

Strumenti di debug e risoluzione dei problemi.

dropstone debug [command]

uninstall

Disinstalla Dropstone e rimuovi tutti i file correlati.

dropstone uninstall

Flag

Flag	Short	Descrizione
	`-c`	Mantieni i file di configurazione
	`-d`	Mantieni i dati della sessione e gli snapshot
		Mostra cosa verrebbe rimosso senza rimuovere
	`-f`	Salta i prompt di conferma

upgrade

Aggiorna Dropstone CLI all'ultima versione o a una versione specifica. dropstone update è un alias e si comporta in modo identico.

dropstone upgrade [target]
# o
dropstone update [target]

Per aggiornare all'ultima versione:

dropstone upgrade

Per installare una versione specifica:

dropstone upgrade 1.0.5

Su Windows, se Dropstone è attualmente in esecuzione, il programma di installazione prepara la nuova build come dropstone.exe.pending. La nuova versione si attiva automaticamente al prossimo avvio: non è necessario spostare manualmente i file.

Flag

Flag	Short	Descrizione
	`-m`	Il metodo di installazione da utilizzare: `curl`, `npm`, `pnpm`, `bun`, `brew`, `scoop`, `choco`

Flag Globali

Dropstone CLI accetta i seguenti flag globali.

Flag	Short	Descrizione
	`-h`	Visualizza la guida
	`-v`	Stampa il numero di versione
		Stampa i log su stderr
		Livello di log (DEBUG, INFO, WARN, ERROR)
		Esegui senza plugin esterni

Variabili di ambiente

Dropstone legge le seguenti variabili di ambiente all'avvio. Queste sono le variabili supportate rivolte all'utente; tutto ciò che non è elencato qui è interno e potrebbe essere modificato o rimosso senza preavviso.

Variabile	Tipo	Descrizione
`DROPSTONE_API_KEY`	string	Chiave API Dropstone per uso headless / CI (salta l'accesso al browser)
`DROPSTONE_CONFIG`	string	Percorso di un file di configurazione `dropstone.json`
`DROPSTONE_TUI_CONFIG`	string	Percorso di un file di configurazione della sessione (`tui.json`)
`DROPSTONE_DISABLE_AUTOUPDATE`	boolean	Disabilita i controlli di aggiornamento automatico della CLI
`DROPSTONE_GIT_BASH_PATH`	string	Percorso di Git Bash su Windows (utilizzato come strumento shell)
`DROPSTONE_SERVER_PASSWORD`	string	Abilita l'autenticazione HTTP basic su `dropstone serve` / `dropstone web`
`DROPSTONE_SERVER_USERNAME`	string	Sostituisci il nome utente di autenticazione basic (predefinito `dropstone`)

Core concepts

Interactive session

CLI

tui

Flag

Comandi

agent

create

Flag

list

attach

Flag

auth

login

Flag

list

logout

github

install

run

Flag

mcp

add

list

auth

logout

debug

models

Flag

run

Flag

serve

Flag

session

list

Flag

delete

stats

Flag

export

Flag

import

web

Flag

acp

Flag

plugin

Flag

pr

db

Flag

path

debug

uninstall

Flag

upgrade

Flag

Flag Globali

Variabili di ambiente

In questa pagina