Dropstone Docs

Übersicht

Dropstone CLI ist ein agentisches Codierungstool, das in deinem Terminal läuft. Bitte es, Code zu lesen, Befehle auszuführen, Änderungen zu planen und Dateien zu bearbeiten – alles direkt aus deiner Shell.

Dropstone ist der schnellste Weg zu agentischem Codieren, wenn du im Terminal lebst. Diese Seite bringt dich zur Installation, Anmeldung und in dein erstes Gespräch.

Voraussetzungen

  • Ein moderner Terminal-Emulator. Jeder funktioniert; wir testen mit WezTerm, Alacritty, Ghostty und Kitty.
  • Ein Dropstone-Konto. Melde dich auf dropstone.io an, um die integrierte Modellreihe (Fast, Pro, Heavy) zu nutzen.

Installation

Homebrew (empfohlen):

brew tap blankline-org/dropstone-cli
brew install dropstone

Oder das Installationsskript:

curl -fsSL https://dropstone.io/install | bash

Beide Methoden legen eine einzelne dropstone-Binärdatei in deinen PATH. Kein Node, keine Laufzeitabhängigkeiten.

Überprüfe die Installation:

dropstone --version

Anmelden

Wechsle in ein beliebiges Projektverzeichnis und starte Dropstone:

cd /path/to/your/project
dropstone

Beim ersten Start wirst du aufgefordert, dich anzumelden. Zwei Optionen:

  1. Im Browser fortfahren (empfohlen). Öffnet dropstone.io/login, meldet dich an und übergibt das Token automatisch an die CLI. Verwendet PKCE, sodass das Token nie in der URL-Leiste deines Browsers erscheint.
  2. Ein Token einfügen. Für SSH- oder Headless-Sitzungen. Hole ein Token auf dropstone.io/account und füge es ein.

Führe /login innerhalb von Dropstone aus, um später das Konto zu wechseln.

Ein Modell auswählen

Dropstone bietet drei Modellstufen. Alle drei werden auf US-Infrastruktur gehostet und für Codierung optimiert.

StufeAm besten geeignet für
FastSchnelle Bearbeitungen, Gerüstbau, Refactorings einzelner Dateien. Die Standardstufe.
ProRefactorings mehrerer Dateien, übergreifende Änderungen, breiteres Denken.
HeavyArchitekturentscheidungen, große Migrationen, mehrdeutiges oder forschungsintensives Debugging.

Wechsle die Stufen während einer Sitzung mit /effort low, /effort medium, /effort high oder /effort xhigh. Ctrl+T durchläuft sie. Siehe Modelle für mehr.

Ein Projekt initialisieren

Führe im Projektstamm aus:

/init

Dropstone scannt deine Projektstruktur und erstellt eine AGENTS.md-Datei im Repository-Stamm. Committe sie in git: Hier kodierst du die Projektkonventionen, Build-Befehle und Stolperfallen, die Dropstone bei jeder Eingabe kennen sollte.

Siehe Regeln (AGENTS.md) für das vollständige Format.

Erstes Gespräch

Du bist bereit. Stelle Fragen, fordere Änderungen an oder plane Funktionen.

Nach dem Code fragen

Wie wird die Authentifizierung in @src/auth/session.ts behandelt?

Verwende @, um Dateien per Fuzzy-Suche zu finden und in die Eingabe zu pinnen.

Planen vor dem Bauen

Drücke Tab, um in den Plan-Modus zu wechseln. Im Plan-Modus kann Dropstone keine Dateien bearbeiten; es beschreibt nur, was es tun würde.

Füge eine "deleted_at"-Spalte zur Notizen-Tabelle hinzu. Erstelle dann einen Bildschirm,
der kürzlich gelöschte Notizen mit Wiederherstellen- und Endgültig-Löschen-Buttons auflistet.

Verfeinere den Plan. Wenn du zufrieden bist, drücke Tab erneut, um in den Build-Modus zurückzukehren und ihm zu sagen, dass er loslegen soll.

Direkte Bearbeitungen

Für kleine Änderungen überspringe den Plan:

Füge Auth zu /settings hinzu, genauso wie es in /notes behandelt wird.

Rückgängig machen und wiederholen

/undo
/redo

/undo macht den vorherigen Bearbeitungszyklus rückgängig und zeigt deine Eingabe erneut an, damit du sie anpassen kannst. Führe es mehrmals aus, um weiter zurückzugehen. /redo spielt einen rückgängig gemachten Schritt erneut ab.

Nutzung und Limits

Tippe /usage, um deine wöchentliche Nutzung, Planstufe und den Reset-Countdown zu sehen. Tippe /upgrade, um die Preisseite zu öffnen, wenn du mehr Spielraum benötigst.

Strg+I