CLI
Dropstone CLI Optionen und Befehle.
Die Dropstone CLI startet standardmäßig eine interaktive Sitzung, wenn sie ohne Argumente ausgeführt wird.
dropstone
Sie akzeptiert aber auch Befehle wie auf dieser Seite dokumentiert. Dies ermöglicht es Ihnen, mit Dropstone programmgesteuert zu interagieren.
dropstone run "Explain how closures work in JavaScript"
tui
Starten Sie eine interaktive Dropstone-Sitzung. Dies ist die Standardeinstellung, wenn Sie dropstone ohne Unterbefehl ausführen; dropstone tui ist die explizite Form.
dropstone [project]
Flags
| Flag | Short | Beschreibung |
|---|---|---|
| -c | Letzte Sitzung fortsetzen |
| -s | Sitzungs-ID zum Fortsetzen |
| Sitzung beim Fortsetzen verzweigen (mit --continue oder --session verwenden) | |
| Zu verwendende Eingabeaufforderung | |
| -m | Zu verwendendes Modell (dropstone/dropstone-fast, dropstone/dropstone-pro oder dropstone/dropstone-heavy) |
| Zu verwendender Agent | |
| Port zum Abhören | |
| Hostname zum Abhören | |
| mDNS-Erkennung aktivieren | |
| Benutzerdefinierter mDNS-Domänenname | |
| Zusätzliche Browser-Ursprünge für CORS zulassen |
Befehle
Die Dropstone CLI hat auch die folgenden Befehle.
agent
Verwalten Sie Agenten für Dropstone.
dropstone agent [command]
create
Erstellen Sie einen neuen Agent mit benutzerdefinierter Konfiguration.
dropstone agent create
Dieser Befehl führt Sie durch die Erstellung eines neuen Agenten mit einer benutzerdefinierten Systemaufforderung und Berechtigungskonfiguration. Alles, was Sie nicht zulassen, wird in der generierten Frontmatter des Agenten verweigert.
Flags
| Flag | Short | Beschreibung |
|---|---|---|
| Verzeichnis zum Schreiben der Agent-Datei (Standard: global oder .dropstone/agent basierend auf der Eingabeaufforderung) | |
| Was der Agent tun soll | |
| Agent-Modus: all, primary oder subagent | |
| Kommagetrennte Liste der zuzulassenden Berechtigungen (Standard: alle). Verfügbar: bash, read, edit, glob, grep, webfetch, task, todowrite, websearch, lsp, skill. Alles Weggelassene wird verweigert. Alias: --tools | |
| -m | Zu verwendendes Modell (dropstone/dropstone-fast, dropstone/dropstone-pro oder dropstone/dropstone-heavy) |
Das Übergeben aller --path, --description, --mode und --permissions führt den Befehl nicht interaktiv aus.
list
Listet alle verfügbaren Agenten auf.
dropstone agent list
attach
Verbinden Sie ein Terminal mit einem bereits laufenden Dropstone-Backend-Server, der über die Befehle serve oder web gestartet wurde.
dropstone attach [url]
Dies ermöglicht es Ihnen, eine interaktive Sitzung auf einen Dropstone-Server auf einem anderen Computer zu verweisen. Zum Beispiel:
# Starten Sie den Server auf dem Host-Computer
dropstone web --port 4096 --hostname 0.0.0.0
# Verbinden Sie auf einem anderen Computer eine Sitzung damit
dropstone attach http://10.20.30.40:4096
Flags
| Flag | Short | Beschreibung |
|---|---|---|
| Arbeitsverzeichnis zum Starten der Sitzung | |
| -c | Letzte Sitzung fortsetzen |
| -s | Sitzungs-ID zum Fortsetzen |
| Sitzung beim Fortsetzen verzweigen (mit --continue oder --session verwenden) | |
| -p | Passwort für Basic Auth (Standard: DROPSTONE_SERVER_PASSWORD) |
| -u | Benutzername für Basic Auth (Standard: DROPSTONE_SERVER_USERNAME oder dropstone) |
auth
Befehl zum Verwalten von Anmeldedaten und Anmeldung für Anbieter.
dropstone auth [command]
login
Verwenden Sie dropstone auth login, um sich bei Dropstone anzumelden. Ihre Anmeldedaten werden unter ~/.local/share/dropstone/auth.json gespeichert.
dropstone auth login
Dropstone liest die Anmeldedaten aus dieser Datei bei jedem Start.
Flags
| Flag | Short | Beschreibung |
|---|---|---|
| -p | Anbieter-ID oder Name zum Anmelden |
| -m | Anmeldeverfahren-Label zum Verwenden, Auswahl überspringen |
list
Listet alle authentifizierten Anbieter auf, wie in der Anmeldedatei gespeichert.
dropstone auth list
Oder die Kurzversion.
dropstone auth ls
logout
Melden Sie sich von einem Anbieter ab, indem Sie ihn aus der Anmeldedatei löschen.
dropstone auth logout
github
Verwalten Sie den GitHub-Agent für Repository-Automatisierung.
dropstone github [command]
install
Installieren Sie den GitHub-Agent in Ihrem Repository.
dropstone github install
Dies richtet den erforderlichen GitHub Actions-Workflow ein und führt Sie durch den Konfigurationsprozess. Weitere Informationen.
run
Führen Sie den GitHub-Agent aus. Dies wird normalerweise in GitHub Actions verwendet.
dropstone github run
Flags
| Flag | Beschreibung |
|---|---|
| GitHub Mock-Event zum Ausführen des Agenten |
| GitHub persönliches Zugriffstoken |
mcp
Verwalten Sie Model Context Protocol-Server.
dropstone mcp [command]
add
Fügen Sie einen MCP-Server zu Ihrer Konfiguration hinzu.
dropstone mcp add
Dieser Befehl führt Sie durch das Hinzufügen eines lokalen oder Remote-MCP-Servers.
list
Listet alle konfigurierten MCP-Server und ihren Verbindungsstatus auf.
dropstone mcp list
Oder verwenden Sie die Kurzversion.
dropstone mcp ls
auth
Authentifizieren Sie sich mit einem OAuth-fähigen MCP-Server.
dropstone mcp auth [name]
Wenn Sie keinen Servernamen angeben, werden Sie aufgefordert, einen aus den verfügbaren OAuth-fähigen Servern auszuwählen.
Sie können auch OAuth-fähige Server und ihren Authentifizierungsstatus auflisten.
dropstone mcp auth list
Oder verwenden Sie die Kurzversion.
dropstone mcp auth ls
logout
Entfernen Sie OAuth-Anmeldedaten für einen MCP-Server.
dropstone mcp logout [name]
debug
Debuggen Sie OAuth-Verbindungsprobleme für einen MCP-Server.
dropstone mcp debug <name>
models
Listet die Dropstone-Modell-Tiers auf, die für Ihr Konto verfügbar sind.
dropstone models
Die Ausgabe ist im Format dropstone/<tier>. Dropstone wird mit drei Tiers ausgeliefert:
| Modell-ID | Tier | Am besten für |
|---|---|---|
dropstone/dropstone-fast | Fast | Standard-Allzweck-Modell. Schnelle Bearbeitungen, Gerüstbau, Konversations-Debugging. |
dropstone/dropstone-pro | Pro | Multi-Datei-Refaktorisierungen, übergreifende Änderungen, breiteres Denken. |
dropstone/dropstone-heavy | Heavy | Architekturentscheidungen, große Migrationen, schwieriges Debugging. |
Siehe Models für die vollständige Aufschlüsselung und wie Sie einen Standard festlegen.
Flags
| Flag | Beschreibung |
|---|---|
| Aktualisieren Sie die zwischengespeicherte Modellliste |
| Metadaten einschließen (Kontextfenster, Fähigkeiten) |
run
Führen Sie Dropstone im nicht-interaktiven Modus aus, indem Sie eine Eingabeaufforderung direkt übergeben.
dropstone run [message..]
Dies ist nützlich für Scripting, Automatisierung oder wenn Sie eine schnelle Antwort ohne Öffnen einer interaktiven Sitzung möchten. Zum Beispiel:
dropstone run Explain the use of context in Go
Sie können auch an eine laufende dropstone serve-Instanz anhängen, um Kaltstart-Zeiten von MCP-Servern bei jedem Lauf zu vermeiden:
# Starten Sie einen Headless-Server in einem Terminal
dropstone serve
# Führen Sie in einem anderen Terminal Befehle aus, die sich damit verbinden
dropstone run --attach http://localhost:4096 "Explain async/await in JavaScript"
Flags
| Flag | Short | Beschreibung |
|---|---|---|
| Der auszuführende Befehl, verwenden Sie message für Argumente | |
| -c | Letzte Sitzung fortsetzen |
| -s | Sitzungs-ID zum Fortsetzen |
| Sitzung beim Fortsetzen verzweigen (mit --continue oder --session verwenden) | |
| Sitzung teilen | |
| -m | Zu verwendendes Modell (dropstone/dropstone-fast, dropstone/dropstone-pro oder dropstone/dropstone-heavy) |
| Zu verwendender Agent | |
| -f | Datei(en) zum Anhängen an die Nachricht |
| Format: default (formatiert) oder json (rohe JSON-Ereignisse) | |
| Titel für die Sitzung (verwendet gekürzte Eingabeaufforderung, wenn kein Wert angegeben) | |
| An einen laufenden Dropstone-Server anhängen (z. B. http://localhost:4096) | |
| -p | Passwort für Basic Auth (Standard: DROPSTONE_SERVER_PASSWORD) |
| -u | Benutzername für Basic Auth (Standard: DROPSTONE_SERVER_USERNAME oder dropstone) |
| Verzeichnis zum Ausführen oder Pfad auf dem Remote-Server beim Anhängen | |
| Port für den lokalen Server (Standard: zufälliger Port) | |
| Modellvariante (anbieter-spezifische Reasoning-Anstrengung) | |
| Thinking-Blöcke anzeigen | |
| Berechtigungen automatisch genehmigen, die nicht explizit verweigert werden (gefährlich!) |
serve
Starten Sie einen Headless-Dropstone-Server für API-Zugriff. Schauen Sie sich die Server-Dokumentation für die vollständige HTTP-Schnittstelle an.
dropstone serve
Dies startet einen Headless-HTTP-Server, der programmgesteuerten Zugriff auf Dropstone bietet, ohne eine interaktive Sitzung zu öffnen. Setzen Sie DROPSTONE_SERVER_PASSWORD, um HTTP Basic Auth zu aktivieren (Benutzername Standard: dropstone).
Flags
| Flag | Beschreibung |
|---|---|
| Port zum Abhören |
| Hostname zum Abhören |
| mDNS-Erkennung aktivieren |
| Benutzerdefinierter mDNS-Domänenname |
| Zusätzliche Browser-Ursprünge für CORS zulassen |
session
Verwalten Sie Dropstone-Sitzungen.
dropstone session [command]
list
Listet alle Dropstone-Sitzungen auf.
dropstone session list
Flags
| Flag | Short | Beschreibung |
|---|---|---|
| -n | Auf die N neuesten Sitzungen begrenzen |
| Ausgabeformat: table oder json (table) |
delete
Löschen Sie eine Dropstone-Sitzung.
dropstone session delete <sessionID>
stats
Zeigen Sie Token-Nutzungs- und Kostenstatistiken für Ihre Dropstone-Sitzungen an.
dropstone stats
Flags
| Flag | Beschreibung |
|---|---|
| Statistiken für die letzten N Tage anzeigen (alle Zeit) |
| Anzahl der anzuzeigenden Tools (alle) |
| Modellnutzungs-Aufschlüsselung anzeigen (standardmäßig verborgen). Geben Sie eine Zahl ein, um die Top N anzuzeigen |
| Nach Projekt filtern (alle Projekte, leere Zeichenfolge: aktuelles Projekt) |
export
Exportieren Sie Sitzungsdaten als JSON.
dropstone export [sessionID]
Wenn Sie keine Sitzungs-ID angeben, werden Sie aufgefordert, eine aus den verfügbaren Sitzungen auszuwählen.
Flags
| Flag | Beschreibung |
|---|---|
| Vertrauliche Transkript-/Dateidaten redigieren |
import
Importieren Sie Sitzungsdaten aus einer JSON-Datei oder einer Dropstone-Share-URL.
dropstone import <file>
Sie können aus einer lokalen Datei oder einer Dropstone-Share-URL importieren.
dropstone import session.json
dropstone import https://dropstone.io/s/abc123
web
Starten Sie einen Headless-Dropstone-Server mit einer Web-Schnittstelle.
dropstone web
Dies startet einen HTTP-Server und öffnet einen Webbrowser, um auf Dropstone über eine Web-Schnittstelle zuzugreifen. Setzen Sie DROPSTONE_SERVER_PASSWORD, um HTTP Basic Auth zu aktivieren (Benutzername Standard: dropstone).
Flags
| Flag | Beschreibung |
|---|---|
| Port zum Abhören |
| Hostname zum Abhören |
| mDNS-Erkennung aktivieren |
| Benutzerdefinierter mDNS-Domänenname |
| Zusätzliche Browser-Ursprünge für CORS zulassen |
acp
Starten Sie einen ACP (Agent Client Protocol)-Server.
dropstone acp
Dieser Befehl startet einen ACP-Server, der über stdin/stdout mit nd-JSON kommuniziert.
Flags
| Flag | Beschreibung |
|---|---|
| Arbeitsverzeichnis |
| Port zum Abhören |
| Hostname zum Abhören |
| mDNS-Erkennung aktivieren |
| Benutzerdefinierter mDNS-Domänenname |
| Zusätzliche Browser-Ursprünge für CORS zulassen |
plugin
Installieren Sie ein Plugin und aktualisieren Sie Ihre Konfiguration.
dropstone plugin <module>
Oder verwenden Sie den Alias.
dropstone plug <module>
Flags
| Flag | Short | Beschreibung |
|---|---|---|
| -g | In globaler Konfiguration installieren |
| -f | Vorhandene Plugin-Version ersetzen |
pr
Rufen Sie einen GitHub PR-Branch ab, checken Sie ihn aus und führen Sie Dropstone aus.
dropstone pr <number>
db
Datenbanktools.
dropstone db [query]
Flags
| Flag | Beschreibung |
|---|---|
| Ausgabeformat: json oder tsv |
path
Geben Sie den Datenbankpfad aus.
dropstone db path
debug
Debugging- und Troubleshooting-Tools.
dropstone debug [command]
uninstall
Deinstallieren Sie Dropstone und entfernen Sie alle zugehörigen Dateien.
dropstone uninstall
Flags
| Flag | Short | Beschreibung |
|---|---|---|
| -c | Konfigurationsdateien behalten |
| -d | Sitzungsdaten und Snapshots behalten |
| Zeigen Sie an, was entfernt würde, ohne zu entfernen | |
| -f | Bestätigungsaufforderungen überspringen |
upgrade
Aktualisiert die Dropstone CLI auf die neueste Version oder eine bestimmte Version. dropstone update ist ein Alias und verhält sich identisch.
dropstone upgrade [target]
# oder
dropstone update [target]
Zum Aktualisieren auf die neueste Version:
dropstone upgrade
So installieren Sie eine bestimmte Version:
dropstone upgrade 1.0.5
Unter Windows wird das Installationsprogramm, wenn Dropstone gerade läuft, den neuen Build als dropstone.exe.pending bereitstellen. Die neue Version wird beim nächsten Start automatisch aktiviert: keine manuellen Dateiverschiebungen erforderlich.
Flags
| Flag | Short | Beschreibung |
|---|---|---|
| -m | Die zu verwendende Installationsmethode: curl, npm, pnpm, bun, brew, scoop, choco |
Globale Flags
Die Dropstone CLI akzeptiert die folgenden globalen Flags.
| Flag | Short | Beschreibung |
|---|---|---|
| -h | Hilfe anzeigen |
| -v | Versionsnummer drucken |
| Protokolle auf stderr drucken | |
| Protokollebene (DEBUG, INFO, WARN, ERROR) | |
| Ohne externe Plugins ausführen |
Umgebungsvariablen
Dropstone liest beim Start die folgenden Umgebungsvariablen. Dies sind die unterstützten benutzerorientierten Variablen; alles andere ist intern und kann ohne Ankündigung geändert oder entfernt werden.
| Variable | Typ | Beschreibung |
|---|---|---|
DROPSTONE_API_KEY | string | Dropstone API-Schlüssel für Headless-/CI-Nutzung (überspringt Browser-Anmeldung) |
DROPSTONE_CONFIG | string | Pfad zu einer dropstone.json Konfigurationsdatei |
DROPSTONE_TUI_CONFIG | string | Pfad zu einer Sitzungskonfigurationsdatei (tui.json) |
DROPSTONE_DISABLE_AUTOUPDATE | boolean | Automatische CLI-Update-Prüfungen deaktivieren |
DROPSTONE_GIT_BASH_PATH | string | Pfad zu Git Bash unter Windows (wird als Shell-Tool verwendet) |
DROPSTONE_SERVER_PASSWORD | string | HTTP Basic Auth auf dropstone serve / dropstone web aktivieren |
DROPSTONE_SERVER_USERNAME | string | Benutzername für Basic Auth überschreiben (Standard dropstone) |