Schnellstart

Installieren Sie Dropstone, melden Sie sich an und liefern Sie Ihre erste Änderung in unter fünf Minuten. Dieser Leitfaden bringt Sie von null zu einer funktionierenden Agent-Schleife.

Am Ende dieses Leitfadens haben Sie Dropstone installiert, angemeldet und echte Änderungen in einem Projekt Ihrer Wahl vorgenommen.

Bevor Sie beginnen

Sie benötigen:

Ein Terminal oder eine Eingabeaufforderung
Ein Projekt auf der Festplatte, auf das Sie Dropstone ausrichten (beliebige Sprache, beliebige Größe)
Ein Dropstone-Konto, das Sie unter dropstone.io erstellen können

Schritt 1: Dropstone installieren

Wählen Sie den Installationspfad für Ihre Plattform.

Homebrew (empfohlen):

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

Oder das Installationsskript:

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

Beide Methoden installieren eine einzelne dropstone-Binärdatei auf Ihrem PATH. Kein Node, keine Laufzeitabhängigkeiten.

Überprüfen Sie die Installation:

dropstone --version

Sie sollten eine Versionsnummer sehen (die aktuelle Version ist 1.0.8). Die Binärdatei aktualisiert sich im Hintergrund selbst, sodass Sie ohne erneutes Ausführen des Installationsprogramms auf dem neuesten Stand bleiben.

Schritt 2: Anmelden

Wechseln Sie in ein beliebiges Projektverzeichnis und starten Sie Dropstone:

cd /pfad/zu/ihrem/projekt
dropstone

Beim ersten Start werden Sie aufgefordert, sich anzumelden. Zwei Optionen:

Im Browser fortfahren (empfohlen). Öffnet dropstone.io/login, meldet Sie an und übergibt das Token automatisch an die CLI. Verwendet PKCE, sodass das Token nie in der Browser-URL-Leiste erscheint.
Token einfügen. Für SSH- oder Headless-Sitzungen. Holen Sie sich ein Token unter dropstone.io/account und fügen Sie es ein.

Ihre Anmeldedaten werden nach der ersten Anmeldung auf der Festplatte gespeichert. Um später das Konto zu wechseln, führen Sie /login innerhalb von Dropstone aus.

Schritt 3: Erste Sitzung starten

Sie sehen jetzt den Dropstone-Startbildschirm. Drei Dinge sind zu beachten:

Ihre aktuelle Modellstufe wird oben rechts angezeigt (Standard: Dropstone Fast)
Das Eingabefeld unten ist zum Tippen
Slash-Befehle beginnen mit /. Probieren Sie /help, um alle zu sehen

Geben Sie eine beliebige natürlichsprachliche Eingabe ein, um eine Sitzung zu starten. Es gibt keine spezielle Syntax zu lernen.

Schritt 4: Erste Frage stellen

Lassen Sie Dropstone das Projekt für Sie erkunden. Probieren Sie eine dieser Optionen:

was macht dieses Projekt?

was sind die Haupteinstiegspunkte?

erkläre die Ordnerstruktur

Dropstone liest Dateien bei Bedarf und antwortet mit Zitaten aus dem tatsächlichen Code. Sie müssen keine Dateien einfügen oder Kontext manuell schreiben.

Sie können Dropstone auch nach sich selbst fragen:

was kannst du in diesem Projekt tun?

welche Befehle darfst du ausführen?

Schritt 5: Erste Codeänderung vornehmen

Beschreiben Sie nun eine kleine Änderung. Für ein neues Projekt versuchen Sie etwas mit geringem Risiko:

füge eine README mit einer einseitigen Projektbeschreibung hinzu

Für ein bestehendes Projekt:

füge Eingabevalidierung zur Funktion hinzu, die einen Benutzer erstellt

Dropstone wird:

Die relevante Datei finden
Die vorgeschlagene Änderung als Diff anzeigen
Vor dem Schreiben um Ihre Genehmigung bitten
Das Ergebnis überprüfen (Typprüfungen, Tests, Lints, falls verfügbar)

Berechtigungen:

Dropstone fragt beim ersten Mal um Genehmigung, wenn es eine Datei bearbeiten oder einen Shell-Befehl ausführen möchte. Genehmigen Sie einmal, und dieselbe Operation in derselben Sitzung läuft ohne erneute Aufforderung. Verwenden Sie /permissions, um Ihre erlaubten Aktionen anzuzeigen oder zu widerrufen.

Schritt 6: Mit git arbeiten

Dropstone behandelt git als erstklassiges Werkzeug:

welche Dateien habe ich geändert?

committe meine Änderungen mit einer beschreibenden Nachricht

erstelle einen Branch namens feature/health-endpoint und wechsle zu ihm

zeige die letzten fünf Commits

hilf mir, den Merge-Konflikt in src/auth.ts zu lösen

Für PR-Workflows (Pull-Requests öffnen, PR-Beschreibungen generieren, Review-Kommentare posten) siehe GitHub-Integration.

Schritt 7: Fehler beheben oder Funktion hinzufügen

Beschreiben Sie in einfacher Sprache, was Sie möchten. Dropstone findet den Code, versteht den Kontext, implementiert die Änderung und überprüft sie.

es gibt einen Fehler, bei dem leere Suchanfragen alle Ergebnisse zurückgeben - behebe ihn

füge einen /healthz-Endpunkt zum API-Server hinzu, der Build-Informationen zurückgibt

das Login-Formular stürzt ab, wenn die E-Mail fehlt - finde heraus warum und behebe es

Wenn die Aufgabe mehrere Dateien umfasst, schreibt Dropstone einen kurzen Plan und führt ihn Schritt für Schritt aus. Sie können jederzeit Esc drücken, um zu unterbrechen und zu steuern.

Schritt 8: Andere häufige Workflows ausprobieren

Einige Muster, bei denen Dropstone gut ist:

Refactoring

refaktoriere das Auth-Modul, um async/await statt Callbacks zu verwenden

Tests schreiben

schreibe Unit-Tests für die Rechnerfunktionen

Code-Review

überprüfe meine gestagten Änderungen und weise auf alles Riskante hin

Dokumentation

aktualisiere die README-Installationsanweisungen, um den WSL-Pfad einzuschließen

Tipp:

Sprechen Sie mit Dropstone wie mit einem Teammitglied. Beschreiben Sie, was Sie erreichen möchten, nicht die genauen Schritte dorthin. Der Agent ist am besten bei der Planung, wenn Sie die Implementierungsentscheidungen ihm überlassen.

Wichtige Befehle

Die wenigen Befehle, die Sie tatsächlich verwenden werden:

Befehl	Funktion	Beispiel
`dropstone`	Startet eine interaktive Sitzung im aktuellen Verzeichnis	`dropstone`
`dropstone run "aufgabe"`	Führt eine einmalige Aufgabe aus und beendet sich	`dropstone run "erkläre auth.ts"`
`dropstone -c`	Setzt die letzte Sitzung in diesem Verzeichnis fort	`dropstone -c`
`dropstone --session ID`	Setzt eine bestimmte Sitzung per ID fort	`dropstone --session 7f3a...`
`/help`	Zeigt alle Slash-Befehle	innerhalb einer Sitzung
`/effort`	Wechselt die Modellstufe für diese Sitzung	`/effort high`
`/clear`	Löscht die aktuelle Unterhaltung	innerhalb einer Sitzung
`/login`	Wechselt Konten	innerhalb einer Sitzung
`exit` oder `Ctrl+D`	Beendet Dropstone

Die vollständige Referenz finden Sie auf den Seiten CLI und Slash-Befehle.

Profi-Tipps für neue Benutzer

Was kommt als Nächstes

CLI-Referenz

Jedes Flag, jeder Unterbefehl, jede Option. Die Seite, die Sie sich merken.

Slash-Befehle

Alle Slash-Befehle an einem Ort. Praktisch nach einer Woche Nutzung.

Dropstone Ihr Repo beibringen (AGENTS.md)

Legen Sie eine Datei im Repo-Root ab, die Dropstone Ihre Konventionen, Build-Befehle und Stolperfallen mitteilt.

Eigene Tools anbinden (MCP)

Binden Sie Datenbanken, interne APIs, Ticketsysteme oder alles, was Model Context Protocol spricht, ein.

Modelle & Anbieter

Mehr zu Fast 1.6, Pro 1.6 und Heavy 1.6 sowie zum Festlegen eines Standards in Ihrer Konfiguration.

Berechtigungen

Steuern Sie genau, was Dropstone in Ihren Projekten lesen, schreiben und ausführen darf.

Hilfe erhalten

Innerhalb von Dropstone tippen Sie /help oder fragen Sie in einfacher Sprache ("wie wechsle ich Modelle?")
Durchsuchen Sie die restliche Dokumentation unter docs.dropstone.io
Melden Sie ein Problem oder eine Feature-Anfrage unter dropstone.io/contact

Overview

Pricing