Dropstone Docs

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

FlagShortBeschreibung
-cLetzte Sitzung fortsetzen
-sSitzungs-ID zum Fortsetzen
Sitzung beim Fortsetzen verzweigen (mit --continue oder --session verwenden)
Zu verwendende Eingabeaufforderung
-mZu 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

FlagShortBeschreibung
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
-mZu 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

FlagShortBeschreibung
Arbeitsverzeichnis zum Starten der Sitzung
-cLetzte Sitzung fortsetzen
-sSitzungs-ID zum Fortsetzen
Sitzung beim Fortsetzen verzweigen (mit --continue oder --session verwenden)
-pPasswort für Basic Auth (Standard: DROPSTONE_SERVER_PASSWORD)
-uBenutzername 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
FlagShortBeschreibung
-pAnbieter-ID oder Name zum Anmelden
-mAnmeldeverfahren-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
FlagBeschreibung
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-IDTierAm besten für
dropstone/dropstone-fastFastStandard-Allzweck-Modell. Schnelle Bearbeitungen, Gerüstbau, Konversations-Debugging.
dropstone/dropstone-proProMulti-Datei-Refaktorisierungen, übergreifende Änderungen, breiteres Denken.
dropstone/dropstone-heavyHeavyArchitekturentscheidungen, große Migrationen, schwieriges Debugging.

Siehe Models für die vollständige Aufschlüsselung und wie Sie einen Standard festlegen.

Flags

FlagBeschreibung
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

FlagShortBeschreibung
Der auszuführende Befehl, verwenden Sie message für Argumente
-cLetzte Sitzung fortsetzen
-sSitzungs-ID zum Fortsetzen
Sitzung beim Fortsetzen verzweigen (mit --continue oder --session verwenden)
Sitzung teilen
-mZu verwendendes Modell (dropstone/dropstone-fast, dropstone/dropstone-pro oder dropstone/dropstone-heavy)
Zu verwendender Agent
-fDatei(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)
-pPasswort für Basic Auth (Standard: DROPSTONE_SERVER_PASSWORD)
-uBenutzername 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

FlagBeschreibung
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
FlagShortBeschreibung
-nAuf 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

FlagBeschreibung
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

FlagBeschreibung
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

FlagBeschreibung
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

FlagBeschreibung
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

FlagShortBeschreibung
-gIn globaler Konfiguration installieren
-fVorhandene 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

FlagBeschreibung
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

FlagShortBeschreibung
-cKonfigurationsdateien behalten
-dSitzungsdaten und Snapshots behalten
Zeigen Sie an, was entfernt würde, ohne zu entfernen
-fBestä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

FlagShortBeschreibung
-mDie zu verwendende Installationsmethode: curl, npm, pnpm, bun, brew, scoop, choco

Globale Flags

Die Dropstone CLI akzeptiert die folgenden globalen Flags.

FlagShortBeschreibung
-hHilfe anzeigen
-vVersionsnummer 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.

VariableTypBeschreibung
DROPSTONE_API_KEYstringDropstone API-Schlüssel für Headless-/CI-Nutzung (überspringt Browser-Anmeldung)
DROPSTONE_CONFIGstringPfad zu einer dropstone.json Konfigurationsdatei
DROPSTONE_TUI_CONFIGstringPfad zu einer Sitzungskonfigurationsdatei (tui.json)
DROPSTONE_DISABLE_AUTOUPDATEbooleanAutomatische CLI-Update-Prüfungen deaktivieren
DROPSTONE_GIT_BASH_PATHstringPfad zu Git Bash unter Windows (wird als Shell-Tool verwendet)
DROPSTONE_SERVER_PASSWORDstringHTTP Basic Auth auf dropstone serve / dropstone web aktivieren
DROPSTONE_SERVER_USERNAMEstringBenutzername für Basic Auth überschreiben (Standard dropstone)
Strg+I